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BASED DATA ACCESS of which the following is a specification. 



SCHEMA" BASED SERVICES FOR IDENTITY -BASED DATA ACCESS 

CROSS REFERENCE TO RELATED APPLICATIONS 

The present application claims priority from co-pending United States provisional 
application serial number 60/275,809, filed March 14, 2001 and entitled "Identity-Based 
Service Communication Using XML Messaging Interfaces", which is hereby incorporated 
herein by reference in its entirety. 

COPYRIGHT DISCLAIMER 

A portion of the disclosure of this patent document contains material that is subject to 
copyright protection. The copyright owner has no objection to the facsimile reproduction by 
anyone of the patent document or the patent disclosure as it appears in the Patent and 
Trademark Office patent file or records, but otherwise reserves all copyright rights 
whatsoever. 

FIELD OF THE INVENTION 

The invention relates generally to computer network data access, and more 
particularly to systems, methods and data structures for accessing data and data-related 
services over a network. 

BACKGROUND OF THE INVENTION 
There are many types of data that users need to manage and otherwise access. For 
example, users keep word processing documents, spreadsheet documents, calendars, 
telephone numbers and addresses, e-mail messages, financial information and so on. In 



general, users maintain this information on various personal computers, hand-held computers, 
pocket-sized computers, personal digital assistants, mobile phones and other electronic 
devices. In most cases, a user's data on one device is not accessible to another device, 
without some manual synchronization process or the like to exchange the data, which is 
cimibersome. Moreover, some devices do not readily allow for synchronization. For 
example, if a user leaves his cell phone at work, he has no way to get his stored phone 
numbers off the cell phone when at home, even if the user has a computing device or similar 
cell phone at his disposal. As is evident, these drawbacks result from the separate devices 
each containing their own data. 

Corporate networks and the like can provide users with remote access to some of their 
data, but many users do not have access to such a network. For many of those that have 
access, connecting to a network with the many different types of devices, assuming such 
devices can even connect to a network, can be a complex or overwhelming problem. 

Moreover, even if a user has centrally stored data, the user needs the correct type of 
device running the appropriate application program to access that data. For example, a user 
with a PDA that runs a simple note taking application program ordinarily will not be able to 
use that program to open documents stored by a full-blown word processing program at work. 
In general, this is because the data is formatted and accessed according to the way the 
application program wants it to be formatted. 

What is needed is a model wherein data is centrally stored for users, with a set of 
services that control access to the data with defined methods, regardless of the application 
program and/or device. When accessed, the data for each service should be structured in a 



defined way that complies with defined rules for that data, regardless of the application 
program or device that is accessing the data. 



SUMMARY OF THE INVENTION 

5 Briefly, the present invention provides a set of services for central (e.g., Internet) 

access to per-user data, based on each user's identity, wherein each service includes a schema 
that defines rules and a structure for the data, and also includes methods that provide access to 
the data in a defined way. Note that while ''user" is generally employed herein for simplicity, 
as used herein the term "user" is really a substitute for any identity, which may be a user, a 
pi 10 group, another entity, an event, a project, and so on. Because the structure of the data is 
4 defined fi-om the perspective of the data, not fi-om that of an application program or a device, 

' 0 programs can communicate with the services to access the data, with existing knowledge of 

Q 

■ . the format. In one implementation, the schemas are arranged as XML documents, and the 

''1 • 5 

l^y services provide methods that control access to the data based on the requestmg user s 

fU 

□ 1 5 identification, defined role and scope for that role. In this way, data can be accessed by its 

U 

owner, and shared to an extent determined by the owner. ExtensibiUty is defined into the 
schemas. 

In one implementation, core services are provided for managing access of various 
types of data, each service corresponding to a defined schema for the type of data it manages. 
20 In addition to defined schemas for the data, the various services implement standard methods 
that apphcation programs can call in order to obtain access to the data, and also may include 
custom metiiods that facilitate access, referred to as domain-specific methods. Core services 
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include myServices, to allow applications to find another service, myApplicationSettings, to 
allow a user to centrally store settings for the user's various applications, and myCalendar, 
which manages access to data regarding scheduled events. Other core services include 
myCategories, to provide a generic classification model, myContacts, to manage access to a 
user's list of contacts, and myDevices, to manage a user's devices. Other, core services 
include myDocuments, myFavorite WebSites, mylnbox, myLists, myLocation, myAlerts, 
myProfile, myPresence and myWallet, as described below. Note that each of these services 
are alternatively and interchangably referred to herein by ".NET" followed by their name, e.g., 
mylnbox may be referred to as .NET Inbox, or simply Inbox, myContacts as .NET Contacts, 
or simply Contacts, and so on. Note that this is only one exemplary set of core services, and 
that other core services implementations may include a different combination of these services 
(i.e. a subset) and/or additional services which may be considered as "core" services. 

Extended (or optional) services are also allowed. The extended services need not be 
provided by the provider of the core services, e.g., there may be a number of users who 
subscribe to one companies core services but only subscribe to third party extended services. 
Likewise, there may be a number of services providers who provide core services or extended 
services but not both. Thus, it should be understood that a core services provider may also 
provides extended services, or providers of core or extended services, or both, may be 
different entities. 

Other benefits and advantages will become apparent fi*om the following detailed 
description when taken in conjunction with the drawings, in which: 



BRIEF DESCRIPTION OF THE DRAWINGS 
FIGURE 1 is a block diagram generally representing an exemplary computer system 
into which the present invention may be incorporated; 

FIG. 2 is a block diagram generally representing a generic data access model in 
5 accordance with one aspect of the present invention; 

FIG. 3 is a representation of services for identity-based data access in accordance with 
one aspect of the present invention; 

FIG. 4 is a block diagram generally representing a schema based service for accessing 
u data arranged in a logical content document based on a defined schema for that service in 
□ 10 accordance with one aspect of the present invention; 

FIGS. 5A and 5B are block diagrams generally representing a mechanism for locating 
S one service by communicating with another service in accordance with one aspect of the 
U present invention; 

l y FIG. 6 is a block diagram generally representing presence information distributed 

1 :fctr 

! *4 5 among endpoints in accordance with one aspect of the present invention; 

FIG. 7 is a block diagram generally representing an arrangement of an alerts service in 
accordance with one aspect of the present invention; 

FIGS. 8-10 are block diagram generally representing publishers and subscribers 
interconnected via a service-to-service conmiunication protocol in accordance with one aspect 
20 of the present invention; 
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FIGS. 1 1-19B comprise flow diagrams generally representing operation of the 
service-to-service communication protocol in accordance with one aspect of the present 
invention; and 

FIGS. 20-21 are block diagram generally representing publishers and subscribers 
interconnected via a service-to-service communication protocol in accordance with an 
alternative aspect of the present invention; and 

FIGS. 22-23 are block diagram generally representing models in which the service-to- 
service communication protocol maybe implemented, in accordance with an aspect of the 
present invention. 

DETAILED DESCRIPTION 

EXEMPLARY OPERATING ENVIRONMENT 

FIGURE 1 illustrates an example of a suitable computing system environment 100 on 
which the invention may be implemented. The computing system environment 100 is only 
one example of a suitable computing environment and is not intended to suggest any 
limitation as to the scope of use or functionality of the invention. Neither should the 
computing environment 100 be interpreted as having any dependency or requirement relating 
to any one or combination of components illustrated in the exemplary operating environment 
100. 

The invention is operational with numerous other general purpose or special purpose 
computing system environments or configurations. Examples of well known computing 
systems, environments, and/or configurations that may be suitable for use with the invention 



include, but are not limited to: personal computers, server computers, hand-held or laptop 
devices, tablet devices, multiprocessor systems, microprocessor-based systems, set top boxes, 
programmable consumer electronics, network PCs, minicomputers, mainframe computers, 
distributed computing envirotmients that include any of the above systems or devices, and the 
5 like. 

The invention may be described in the general context of computer-executable 
instructions, such as program modules, being executed by a computer. Generally, progrma 
modules include routines, programs, objects, components, data structures, and so forth, that 
u perform particular tasks or implement particular abstract data types. The invention may also 
Q 10 be practiced in distributed computing environments where tasks are performed by remote 
J processing devices that are linked throu^ a communications network, hi a distributed 

computing environment, program modules may be located in local and/or remote computer 

■■.'S»f 

j: ^ Storage media including memory storage devices. 

I IJ With reference to FIG. 1, an exemplary system for implementing the uavention 

15 includes a general purpose computing device in the form of a computer 110. Components of 
the computer 110 may include, but are not limited to, a processing unit 120, a system memory 
130, and a system bus 121 that couples various system components including the system 
memory to the processing unit 120. The system bus 121 may be any of several types of bus 
structures including a memory bus or memory controller, a peripheral bus, and a local bus 
20 using any of a variety of bus architectures. By way of example, and not limitation, such 
architectures include Industry Standard Architecture (ISA) bus. Micro Channel Architecture 
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(MCA) bus, Enhanced ISA (EISA) bus, Video Electronics Standards Association (VESA) 
local bus, and Peripheral Component Interconnect (PCI) bus also known as Mezzanine bus. 

The computer 110 typically includes a variety of computer-readable media. 
Computer-readable media can be any available media that can be accessed by the computer 
5 11 0 and includes both volatile and nonvolatile media, and removable and non-removable 
media. By way of example, and not limitation, computer-readable media may comprise 
computer storage media and communication media. Computer storage media includes both 
volatile and nonvolatile, removable and non-removable media implemented in any method or 
I, ^ technology for storage of information such as computer-readable mstructions, data structures, 
Q 10 program modules or other data. Computer storage media mcludes, but is not limited to, 
' ^ RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, digital 
|;i versatile disks (DVD) or other optical disk storage, magnetic cassettes, magnetic tape, 

magnetic disk storage or other magnetic storage devices, or any other medium which can be 
used to store the desired information and which can accessed by the computer 1 10, 
P 1 5 Communication media typically embodies computer-readable instructions, data structures, 
program modules or other data in a modulated data signal such as a carrier wave or other 
transport mechanism and includes any mformation delivery media. The term "modulated data 
signal" means a signal that has one or more of its characteristics set or changed in such a 
manner as to encode information in the signal. By way of example, and not limitation, 
20 communication media includes wired media such as a wired network or direct-wired 
connection, and wireless media such as acoustic, RF, infrared and other wireless media. 
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Combinations of the any of the above should also be included within the scope of computer- 
readable media. 

The system memory 130 includes computer storage media in the form of volatile 
and/or nonvolatile memory such as read only memory (ROM) 131 and random access memory 
5 (RAM) 132. A basic input/output system 133 (BIOS), containing the basic routines that help 
to transfer information between elements within computer 110, such as during start-up, is 
typically stored in ROM 131. RAM 132 typically contains data and/or program modules that 
are immediately accessible to and/or presently being operated on by processing unit 120. By 
way of example, and not limitation, FIG. 1 illustrates operating system 134, apphcation 
10 programs 135, other program modules 136 and program data 137. 

''4 

i:ri The computer 110 may also include other removable/non-removable, 

Q volatile/nonvolatile computer storage media. By way of example only, FIG. 1 illustrates a 
|:f hard disk drive 141 that reads from or writes to non-removable, nonvolatile magnetic media, a 
j: J1 magnetic disk drive 151 that reads from or writes to a removable, nonvolatile magnetic disk 
U 15 152, and an optical disk drive 155 that reads from or writes to a removable, nonvolatile optical 
disk 156 such as a CD ROM or other optical media. Other removable/non-removable, 
volatile/nonvolatile computer storage media that can be used in the exemplary operating 
environment include, but are not limited to, magnetic tape cassettes, flash memory cards, 
digital versatile disks, digital video tape, solid state RAM, solid state ROM, and the like. The 
20 hard disk drive 141 is typically connected to the system bus 121 through a non-removable 
memory interface such as interface 140, and magnetic disk drive 151 and optical disk drive 
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155 are typically connected to the system bus 121 by a removable memory interface, such as 
interface 150. 

The drives and their associated computer storage media, discussed above and 
illustrated in FIG. 1, provide storage of computer-readable instructions, data structures, 
program modules and other data for the computer 1 10. In FIG. 1, for example, hard disk drive 
141 is illustrated as storing operating system 144, application programs 145, other program 
modules 146 and program data 147. Note that these components can either be the same as or 
different from operating system 134, application programs 135, other program modules 136, 
and program data 137. Operating system 144, appUcation programs 145, other program 
modules 146, and program data 147 are given different numbers herein to illustrate that, at a 
minimum, they are different copies. A user may enter commands and information into the 
computer 20 through input devices such as a tablet, or electronic digitizer, 164, a microphone 
163, a keyboard 162 and pointing device 161, commonly referred to as mouse, trackball or 
touch pad. Other input devices not shown in FIG. 1 may include a joystick, game pad, 
satellite dish, scanner, or the like. These and other input devices are often connected to the 
processing unit 120 through a user input interface 160 that is coupled to the system bus, but 
may be connected by other interface and bus structures, such as a parallel port, game port or a 
universal serial bus (USB). A monitor 191 or other type of display device is also connected to 
the system bus 121 via an interface, such as a video interface 190. The monitor 191 may also 
be integrated with a touch-screen panel or the like. Note that the monitor and/or touch screen 
panel can be physically coupled to a housing in which the computing device 1 10 is 
incorporated, such as in a tablet-type personal computer. In addition, computers such as the 
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computing device 1 10 may also include other peripheral output devices such as speakers 195 
and printer 196, which may be connected through an output peripheral interface 194 or the 
like. 

The computer 110 may operate in a networked environment using logical connections 
to one or more remote computers, such as a remote computer 180. The remote computer 180 
may be a personal computer, a server, a router, a network PC, a peer device or other common 
network node, and typically includes many or all of the elements described above relative to 
the computer 1 10, although only a memory storage device 181 has been illustrated in FIG. 1 . 
The logical connections depicted in FIG. 1 include a local area network (LAN) 171 and a wide 
area network (WAN) 173, but may also include other networks. Such networking 
environments are commonplace in offices, aiterprise-wide computer networks, intranets and 
the Internet. For example, in the present invention, the computer system 110 may comprise 
source machine from which data is being migrated, and the remote computer 180 may 
comprise the destination machine. Note however that source and destination machines need 
not be connected by a network or any other means, but instead, data may be migrated via any 
media capable of being written by the source platform and read by the destination platform or 
platforms. 

When used in a LAN networking environment, the computer 1 10 is connected to the 
LAN 171 through a network interface or adapter 170. When used in a WAN networking 
environment, the computer 1 10 typically includes a modem 172 or other means for 
estabUshing communications over the WAN 173, such as the Internet. The modem 172, 
which may be internal or external, may be connected to the system bus 121 via the user input 
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interface 160 or other appropriate mechanism. In a networked environment, program modules 
depicted relative to the computer 1 10, or portions thereof, may be stored in the remote 
memory storage device. By way of example, and not limitation, FIG. 1 illustrates remote 
application programs 1 85 as residing on memory device 181. It will be appreciated that the 
5 network connections shown are exemplary and other means of establishing a communications 
link between the computers may be used. 



DATA ACCESS MODEL 
1,^ The present invention generally operates in an architecture / platform that connects 

i!310 network-based (e.g., Intemet-based) applications, devices and services, and transforms them 

into a user's personal network which works on the user's behalf, and with permissions granted 
i-.^ by the user. To this end, the present invention is generally directed to schema-based services 
I ^ that maintain user, group, corporate or other entity data in a commonly accessible virtual 
fU location, such as the Internet. The present invention is intended to scale to millions of users, 
i «l 15 and be stored reliably, and thus it is likely that a user's data will be distributed among and/or 
replicated to numerous storage devices, such as controlled via a server federation. As such, 
while the present invention will be generally described with respect to an identity-centric 
model that enables a user with an appropriate identity and credentials to access data by 
communicating with various core or other services, it is understood that the schema-based 
20 services described herein are arranged for handling the data of millions of users, sorted on a 
per-user-identity basis. Note that while "user" is generally employed herein for simplicity, as 
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used herein the term '^iser" is really a substitute for any identity, which may be a user, a 
group, another entity, an event, a project, and so on. 

As generally represented in FIG. 2, a data access model 200 includes a generic 
navigation module 202 through which applications 204 and the like may access a wide variety 
5 of identity-based data, such as maintained in an addressable store 206, To access the data, a 
common set of command methods may be used to perform operations on various data 
structures that are constructed from the data in the addressable store 206, even though each of 
those data structures may represent different data and be organized quite differently. Such 
M command methods may describe generic operations that may be desired on a wide variety of 
I'^'^IO data structures, and include, for example, insert, delete, replace, update, query or changequery 

I 

i;g In accordance with one aspect of the present invention and as described in detail 

M« below, the data is accessed according to various schemas, with the schemas corresponding to 
!,:^ identity-based services through which users access their data. As used herein, a "schema" 
15 generally comprises a set of rules that define how a data structure may be organized, e.g., what 
elements are supported, in what order they appear, how many times they ^pear, and so on. In 
addition, a schema may define, via color-coding or other identification mechanisms, what 
portions of an XML document (that corresponds to the data structure) may be operated on. 
Examples of such XML-based documents are described below. The schema may also define 
20 how the structure of the XML document may be extended to include elements not expressly 
mentioned in the schema. 
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As will be understood below, the schemas vary depending on the type of data they are 
intended to organize, e.g., an email-inbox-related schema organizes data differently from a 
schema that organizes a user's favorite websites. Further, the services that employ schemas 
may vary. As such, the generic navigation module 202 has associated therewith a navigation 
5 assistance module 208 that includes or is otherwise associated with one or more schemas 210. 
As will be understood, a navigation assistance module 208 as represented in FIG, 2 
corresponds to one or more services, and possesses the information that defmes how to 
navigate through the various data structures, and may also indicate which command methods 
may be executed on what portions of the data structure. Although in FIG. 2 only one 
j 3 10 navigation assistance module 208 is shown coupled to the generic navigation module 202, 
. 2 there may be multiple navigation assistance modules that may each specialize as desired. For 

h !' ? 

Q example, each navigation assistance module may correspond to one service. Moreover, 
i--^ although the navigation assistance module 208 is illustrated as a separate module, some or all 
I ^ of the operations of the navigation assistance module 208 may be incorporated into the 
I'l 15 generic navigation module 202, and vice versa. In one embodiment, the various data 
structures constructed from the schema and addressable store data may comprise XML 
documents of various XML classes. In that case, the navigation assistance module 208 may 
contain a schema associated with each of the classes of XML documents. 

The present invention provides a number of schema-based services that facihtate data 
20 access based on the identity of a user. Preferably, the user need not obtain a separate identity 
for each service, but rather obtains a single identity via a single set of credentials, such as with 
the Microsoft® Passport online service. With such an identity, a user can access data via these 
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services from virtually any network connectable device capable of rmuiing an application that 
can call the methods of a service. 



SERVICES AND SCHEMAS 
5 ".NET My Services" comprises identity-centric services which may be generally 

implemented in XML (extensible Markup Language) Message Interfaces (XMIs). While the 
present invention will be described with respect to XML and XMI, it can readily be 
appreciated that the present invention is not limited to any particular language or set of 

1=^ interfaces. The .NET My Services model essentially corresponds to one implementation of 

;flO the generic data access model 200 of FIG. 2. 

As generally represented in FIG. 3, .NET My Services 300 is implemented as a set of 

a Web services 301-316, each bound to a .NET Identity (PUID, such as a Passport umque 

1; j identifier similar to a globally unique indentifier when Passport® is the authentication service). 

I H The services 301-316 can communicate with one another via a service-to-service 

rs 5 

15 communications protocol (SSCP), described below. As also described below, each service 
presents itself as a set of XML documents that can be manipulated from an application 
program 202 (FIG. 2) or the like using a set of standard methods and domain-specific 
methods. To this end, a user device 320 (endpoint) ruiming such apphcation programs 
connects a user's appHcations to the services, and the data controlled by those services, such 

20 as over the Intemet or an Intranet, such as over the Internet or an Intranet, Note that endpoints 
can be client devices, applications or services. In keeping with the present invention, virtually 
any device capable of executing software and connecting to a network in any means may thus 
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give a user access to data that the user is allowed to access, such as the user's own data, or 
data that a friend or colleague has specified as being accessible to that particular user. 

In general, a .NET Identity is an identifier assigned to an individual, a group of 
individuals, or some form of organization or project. Using this identifier, services bound to 
that identity can be located and manipulated. A general effect is that each identity (e.g., of a 
user, group or organization) has tied to it a set of services that are partitioned along schema 
boundaries and across different identities. As will be understood, the XML-document-centric 
architecture of .NET My Services provides a model for manipulating and communicating 
service state that is very different from prior data access models. The XML-document-centric 
approach, in conjunction with loose binding to the data exposed by the services, enables new 
classes of application programs. As will also be understood, the .NET My Services model 
300 presents the various services 301-316 using a uniform and consistent service and method 
model, a uniform and consistent data access and manipulation model, and a uniform and 
consistent security authorization model. 

In a preferred implementation, the .NET My Services model 300 is based upon open 
Intemet standards. Services are accessed by means of SOAP (Simple Object Access Protocol) 
messages containing an XML payload. Service input and output is expressed as XML 
document outlines, and each of these document outlines conform to an XML schema 
document. The content is available to a user interacting with the .NET My Services service 
endpoint 320. 

One aspect of the present invention is that a schema essentially describes a web 
service. More particularly, a service author begins to write a web service by defining a 
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schema (e.g., in XML) that defines what the data model looks like, e.g., the supported 
elements, their relative ordering, how many times they appear, and other similar definitions, as 
will become apparent below. This service definition also appUes to an author determining 
what roles and methods are supported, e.g., which operations are supported, and the extent of 
5 the data that can be returned for each method. Another way of stating this concept is that the 
author starts by building a complete definition of a service, such as in XML, and specifies the 
verbs (methods) that an application will use to talk to it. 

At this point, the service author has an XML definition that has been declared, and 
M this declarative definition may be run through a compilation process, resulting in a fully 

10 operational service. It should be noted that a general purpose interpreter-like mechanism may 
, J be fed one of these declarative XML definitions, and result in a service that is capable of 
Q operating. In a simple service (e.g., with no domain-specific methods or complex logic), no 
new code needs to be written to provide such an operational service. As will be understood, 
' W such authoring of a service without coding is possible due to the data driven model of the 
15 present architecture. As will be understood, however, code can also be written to influence 
and or work with the service generation process to add value to a service, and/or provide 
specific, runtime business logic that is not expressible in a declarative way. 

Turning to FIG. 4, in the .NET My Services model, an application 400 requests 
performance of a method that operates on data structures. The application may make a 
20 request that is generic with respect to the type of data structure being operated upon and 

without requiring dedicated executable code for manipulating data structures of any particular 
data type. To this end, the application first contacts a myServices service 3 14 (which may be 
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referred to as .NET Service) to obtain the information needed to communicate with a 
particular service 404, through a set of methods 406 of that service 404. For example, the 
needed information received from the myServices service 314 includes a URI of that service 
404. Note that the service 404 may correspond to essentially any of the services represented 
5 in FIG. 3. The myServices service 3 14 is further described belov^ with respect to FIGS. 5A 
and 5B. 

The service 404 includes or is otherwise associated with a set of methods 406 
including standard methods 408, such as to handle requests directed to insert, delete, replace, 
U update, query or changequery operations on the data. The set of methods of a particular 
i 3 10 service may also include service specific methods 410. In general, the only way in which an 

,2 application can communicate with a service are via that service's methods. 

tn 

Q Each service includes service logic 412 for handling requests and providing suitable 

responses. To tWs end, the sendee logic perfonns various functions such as authorization, 
authentication, and signature validation, and further limits valid users to only the data which 

j; J 15 they are permitted to access. The security aspect of a service is not discussed herein, except to 
note that in general, for otherwise valid users, the user's identity determines whetiier a user 
can access data in a requested manner. To this end, a roleMap 414 comprising service-wide 
roleList document templates 415 and scopes (e.g., part of the overall service's schema 416), in 
conjunction with user-based data maintained in an addressable store 418, determines whether 
20 a particular requested method is allowed, e.g., by forming an identity-based roleList document 
420. If a method is allowed, the scope information in the roleMap 414 determines a shape of 
data to retum, e.g., how much content is allowed to be accessed for this particular user for this 
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particular request. The content is obtained in accordance with a content document 422 in the 
service's schema 416 and the actual user data corresponding to that content document in the 
addressable store 418. Li this manner, a per-identity shaped content document 424 is 
essentially constructed for returning to the user, or for updating the addressable store, as 
appropriate for the method. Note that FIG. 4 includes a number of ID-based roleList 
documents and ID-based content documents, to emphasize that the sCTvice 406 is arranged to 
serve multiple users. Also, in FIG. 4, a system document 426 is present as part of the schema 
416, as described below. 

Returning to FIG. 3, in one implementation, access to .NET My Services 300 is 
accomplished using SOAP messages formatted with .NET My Services-specific header and 
body content. Each of the services will accept these messages by means of an HTTP POST 
operation, and generate a response by "piggy-backing" on the HTTP Response, or by issuing 
an HTTP POST to a .NET MyServices response-processing endpoint 320. In addition to 
HTTP as the message transfer protocol, .NET My Services will support raw SOAP over TCP, 
a transfer protocol known as Direct Internet Message Encapsulation (or DIME). Other 
protocols for transferring messages are feasible. 

Because each of the .NET My Services services are accessed by protocol, no particular 
client-side binding code, object models, API layers, or equivalents are required, and are thus 
optional. The .NET My Services model will support Web Services Description Language 
(WSDL). It is not mandatory that applications wishing to interact with .NET My Services 
services make use of any particular bindings, and such bindings are not described herein. 
Instead, the present invention will be generally described in terms of messages that flow 
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between requestors of a particular service and the service endpoints. In order to interact with 
.NET My Services, a service needs to format a .NET My Services message and deliva: that 
message to a .NET My Services endpoint In order to format a message, a client needs to 
manipulate XML document outlines, and typically perform some simple, known (public- 
5 domain) cryptographic operations on portions of the message. 

In accordance with one aspect of the present invention, and as described in FIG. 4 and 
below, in one preferred implementation, each .NET My Services service presents three logical 
XML documents, a content document 422, roleList document 415 (of the roleMap 414), and a 
i system document 426. These documents are addressable using .NET My Services message 
3 10 headers, and are manipulated using standard .NET My Services methods. In addition to these 
i common methods, each service may include additional domain-specific methods. For 
t example, as described below, the myCalendar service 303 might choose to expose a 
^ "getFreeBusy" method rather than expose free^usy as writeable fragments in the content 

5St? 

y document. 

3 15 Each .NET My Services service thus logically includes a content document 422, which 

in general is the main, service-specific document. The schema for this document 422 is a 
fimction of the class of service, as will become apparent from the description of each service's 
schema below. For example, in the case of the myCalendar service 303, the content document 
presents data in the shape dictated by the myCalendar schema, whereas in the case of the 
20 myFavoriteWebSites service 308, the content document presents data in the shape dictated by 
amyFavoriteWebSites schema. 
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Each service also includes a roleList document 415 that contains roleList information, 
comprising inforaiation that governs access to the data and methods exported by the service 
404. The roleList document is manipulated using the .NET standard data manipulation 
mechanisms. The shape of this document is governed by the .NET core schema's 
roIeListType XML data type. 

Each service also includes a system document 426, which contains service-specific 
system data such as the roleMap, schemaMap, messageMap, version information, and service 
specific global data. The document is manipulated using the standard .NET My Services data 
manipulation mechanism, although modifications are limited in a way that allows only the 
service itself to modify the document. The shape of this system document 426 may be 
governed by the system document schema for the particular service, in that each service may 
extend a base system document type with service specific information. For purposes of 
simplicity herein, the base s>^tem document is described once, rather than for each service, 
with only those services having extended service specific information separately described. 
Notwithstanding, it should be understood that each service includes at least the base system 
portion in its system document. 

As is understood, the present invention is generally directed to schemas, which in 
general comprise a set of rules or standards that definie how a particular type of data can be 
structured. Via the schemas, the meaning of data, rather than just the data itself, may be 
communicated between computer systems. For example, a computer device may recognize 
that a data structure that follows a particular address schema represents an address, enabling 
the computer to "understand" the component part of an address. The computer device may 
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then perform intelligent actions based on the understanding that the data structure represents 
an address. Such actions may include, for example, the presentation of an action menu to the 
user that represents things to do with addresses. Schemas may be stored locally on a device 
and/or globally in a federation's "mega-store." A device can keep a locally-stored schema 
updated by subscribing to an event notification service (in this case, a schema update service) 
that automatically passes messages to the device when the schema is updated. Access to 
globally stored schemas is controlled by the security infrastructure. 

GENERAL SCHEMA COMMONALITY 

The .NET My Services data is defined using annotated XSD (extensible or XML 
Structure Definitions) schema files. The XSD files accurately type the data, but since XSD is 
a verbose and complex language, it is not a particularly efficient way to convey structure and 
meaning. Thus, for purposes of simplicity herein, the schemas are described below in terms 
of schema outlines with accompanying element/attribute descriptions. These document 
outlines accurately show the structure of the data contained within a service. However, 
because the present application is not viewable in color, the nodes, elements and/or attributes 
of the schema outlines (which may be described as bold blue, or blue), are represented in the 
schema outlines as boldface type. Those described as underlined red, or red, are represented 
as underlined type, while others referred to as black are represented in normal type. 

The meaning of these bold (blue), underlined (red) and normal (black) items has 
significance with respect to the data model and to the data language that accesses and 
manipulates the data (e.g., via the insert, delete, replace, update, query, changequery or other 



methods). For example, each document described below contains a root element having an 
element name that matches that of the service, e.g., the myApplicationsSettmgs service has a 
root element named myAppUcationsSettings. The .NET My Services name for this item is the 
root. 

5 Documents contain elements that resemble first-class top-level objects, including, for 

example, <catDe£'> , < myAppUcationsSettings /> (other another name as appropriate) and 
<order/>. Such items are denoted in the outlines as bold (blue), and may be identified using 
an <xdb:blue/> tag. Bold (blue) items define major blocks of data within a service. These 
^ node sets are directly addressable by an identifier attribute, and their change status is tracked 
3 1 0 through a changeNumber attribute. Top-level bold blue items may be considered objects. As 
J seen below, some bold (blue) objects contain nested bold blue objects. They usually contain 
^ fi-equently changing underUned (red) properties, which reduces the amount of synchronization 

traffic. Nested bold (blue) items may be considered property groups, 
y Each bold blue item contains one or more underUned (red) items which are elements 

ii I 

3 15 or attributes. These items may be identified using the <xdb:red/ > tag. These items are special 

t 

in that they may be used within predicates (filters) to aid in xdbrbold blue selection. These 
items are also directly addressable and may be manipulated directly by the data manipulation 
language. 

Each colored red element may contain one or more non-colorized elements and 
20 attributes, which are valid and semantically meaningful XML items in the service document. 
Such items are opaque to the data language. These uncolored (i.e., non-bold or underlined) 
elements and attributes may not be addressed directly, may not be selected in a node selection 
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operation, and may not be used in a predicate node test. Note that if one of these items is in 
the path to an underlined red item, it may be used in a location step to the underlined red item, 
but may not be used as the selected node. Note that being opaque does not mean that the item 
is not considered during schema validation, but rather means that the item may not be used in 
5 a predicate, may not be directly addressed, and may not be inserted by itself As can be 

readily appreciated, in this maimer, the .NET My Services thus limits the granularity of access 
to nodes within the service document, since only xdbrbold blue and xdb:underlined red 
marked items are directly addressable, and only those elements and attributes tagged with the 
xdb:underlined red annotation may be used in predicates to influence node selection. Using 
i;3 10 this technique, the .NET My Services storage system can efficiently manage indexes, increase 
J the performance of node selection, partially shred the document data, and in general (because 

i;fi 

■:2 the node selections are well defined) fine-tune the node selection logic on a per-xdb:blue 

U 

L basis. The primary purpose of the xdb:blue is to define a base-level XML object that is 

(•■ 

I y designed to be operated on as a unit. The primary purpose of the xdb:red items is to aid in the 

I' ii 5 

15 selection of xdb:bold blues. The xdb:red items may be changed by the data language 

primitives so some level of fme-grained manipulation of the data is available, but only in very 
limited ways. 

Bold blue items have unique IDs, which are usually assigned by .NET My Services, 
and are retumed firom update operations within the new blueld node. In all cases, the order of 
20 xaBold blue follows the pre-order traversal of the document XML free. Item IDs are UUIDs 
in the following format (h stands for a hexadecimal digit): hhhhhhhh-hhhh-hhhh-hhhh- 
hhhhhhhhhhhh. 
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In addition to identifiers, names and change numbers, nodes and especially red nodes 
may include creator identifiers, category information, and {any} fields. Category information 
enables data to be grouped and/or distinguished in some way, such as to share certain calendar 
information with golf buddies, send an email to immediately family, designate things such as 
5 which telephone number is the user's primary number, e.g., if a user has a second home, and 
so on. Fields of type "any" may comprise fully-typed, namespace-quaUfied fields that contain 
any type of content (e.g., free-form XML) therein. Such "any" fields thus allow extensibility 
of the schema, yet maintain the defined structure of a schema. 
. ^ In one implementation, the core data-manipulation language implemented by the .NET 

R 10 My Services includes an insertRequest, or insert message. This primitive inserts any schema- 
H valid XML firagment into a selected context, thereby changing the existing state of the 
^ 0 document. A queryRequest, or message, retrieves data, such as to retrieve a document. 

! ^ Multiple queries may be specified in one request, and queries that select nothing are 

1, .A 

f y considered successfiil. It is possible to assert that the number of nodes in the selection falls in 

j y 

j;3 15 a given range. This is expressed using minOccurs and maxOccurs attributes. If a 

u 

i 

minOccurs/maxOccurs test fails on any node, the request is considered unsuccessful. Note 
that this is different from a failure code, which would be returned, for example, for a 
malformed request. 

A deleteRequest primitive deletes the selected nodes and all their children. Note that, 
20 just like for other requests, attributes may be selected as well as elements. Empty selections 
result in successful operations, similar to Query. The minOccurs/maxOccurs tests are 
supported wherever select is allowed. 
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A replaceRequest primitive (replace message) is designed to replace the content of 
each of the selected nodes with the specified new content. Selected nodes themselves are not 
affected in any way. This may be considered as an atomic delete of the content of the selected 
node, followed by an insert. The content (text, attributes, elements) in the selected nodes are 
replaced with the new item specified in this message. The node type of the selected node and 
of the replacement node are thus required to be the same. The changequery request 
essentially returns result comrpising data that has changed. 

As mentioned above, each of the services includes a RoleList document and scope 
information that describes which users have what type of access to which data. For example, 
a data owner will have read/write access to his or her own data, and can provide various types 
of rights to that data to other users based on their E)s, (e.g., read only to some users, read 
write to others). Each role Ust identifier may be associated with a scope, by which the kinds 
of data stored according to a given schema can be controlled per user. For example, a user 
can give a friend (with one identity) access via a service to a home telephone number, home 
address and so forth, but can give other users (with other identities) access only to a business 
telephone number. In general, a scope can be defined such that that it includes everything 
except any specifically listed items, or excludes everything except any specifically listed 
items. 

Base System Document Items 

The system document is a global document for each service, having content and meaning that 
is independent of the puid used to address the service. The document is read only to all users. 
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Each system document contains a set of base items common to each .NET My Services 
service described herein, and is optionally extended by each service to include service-specific 
global information. Throughout the following examples, an "hs'' as in <hs: scope . . .> 
represents the namespace or schematic that may be used to interpret the corresponding 
element. For purposes of avoiding repetition, any extended system information is separately 
described with respect to each service, and the following schema outline illustrates the layout 
and meaning of the information found in the base system document that is common among the 
services: 
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TABLE - /^actual service name*/ system 



<svs:svstem chan2eNumber=" ..." instanceld=" ..." 




xmlns :hs=" http://schemas.microsoft.com/hs/200 1 / 1 0/core" 




xmlns:sys=" http://schemas.microsoft.com/hs/2001/10The /^actual service name*/system" >i,.i 


<hs:svstemVersion chaiigeNumber=" ..." id=" ..." creator=" ..." >i..i 




<hs:versionmajorVersion=",.." minorVersion=" ..." buildNimiber=" ..." qfe=" ... >i..i 


<hs:productReleaseName>i..i</hs:productReleaseName> 




<hs:productImplementationName>i..i</hs:productImplementationName> 




</hs:version> 




<hs:buildDate>i..i</hs:buildDate> 




<hs:buildDetails machine=" ..." branch=" ..." type=" ..." official=" ..." >ij 


</hs:buildDetails> 


</hs:systemVersioii> 




<hs:roleMap chan2eNumber=" ..." id=" ..." creator-' ..." >i i 




^hs' scone id^*' " n^vw/Min/^ii/i 




<hs:name xml:lang==" ..." dir=" ..." >o..unbounded</hs:name> 




<hs: shape base=" ..." >i,a 




<hs:include select=" ..." >o..imbounded'^s:include> 




<hs:exclude select=" ..." >o..unbounded</hs:exclude> 




</hs:shape> 




</hs:scope> 




<hs:roleTemplate name=" ..." priority=" ..." >o..unbounded 




<hs:fiallDescription xml:lang=" ..." dir=" ..." >o.a</hs:fullDescription> 




<hs:methodname=" ..." scopeRef=" ..." >o..unbounded</hs:method> 




</hs:roleTemplate> 




</hs:roleMap> 




<hs:methodMap chan2eNumber=" ..." id=" ..." creator=" ...">i i 




<hs:methodname=" ..." >a.unbounded /a«j?/</hs:method> 




</hs:methodMap> 




<hs:schemaMap chanseNumber=" ..." id=" ..." creator^" ..." >i i 


/flWK/</hs:schema> 


<hs:schema namespace=" ..." schemaLocation=" ..." alias=" ...">o..unbounded 


</hs:schemaMap> 




<hs:wsdIMaD chanseNumber=" ..." id=" ..." creator^" ..">i , 




<hs:wsdl vi^sdlLocation=" ..." >o..unboimded {any}</hs:y/sdl> 




<hs:disco discoLocation==" ..." >o..unbounded /a/tK/</hs:disco> 




<hs:wsil wsilLocation=" ..." >o..unbounded /aiiy/</hs:wsil> 




</hs:wsdIMap> 




</any> 




</sys:system> 





The meaning of tiie attributes and elements shown in the preceding sample document 
outline foUov^, beginning with /system (minOccurs=l maxOccurs=l), the element that 
5 encapsulates a system document common to the various services. Although each service has 
its own system document, the common system document attributes and elements are described 
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once, for purposes of simplicity, with service-specific system document attributes and 
elements specified for each service, below. The /system/@changeNumber (minOccurs=0 
maxOccurs=l) attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /system/@instanceld (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /system/systemVersion (minOccurs=l maxOccurs=l) element defines version 
information describing this instance of the .NET My Services service. The 
/systemVersion/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber attribute is 
designed to facilitate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read-only to apphcations; 
attempts to write this attribute are silently ignored, (e.g., without generating an error). 

The /system/systemVersion/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/systemVersion/@creator (string minOccurs==0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
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/system/systemVersion/version (minOccurs=l maxOccurs=l) element defines major, minor, 
and build number version information. The /system/systemVersion/version/@majorVersion 
(string minOccurs=0 maxOccurs=l) attribute specifies the major version number of the .NET 
My Services Service. 

The /system/systemVersion/version/@minorVersion (string minOccurs=0 
maxOccurs=l) attribute specifies the minor version number of the .NET MyServices service. 
The /system/systemVersion/version/@buildNumber (string minOccurs=0 maxOccurs=l) 
attribute specifies the buildNumber of the .NET MyServices service. The 
/system/systemVersion/version/@qfe (string niinOccurs=0 maxOccurs=l) attribute specifies 
the qfe version number of the .NET MyServices service. The 

/system/systemVersion/version/productReleaseName (string minOccurs=l maxOccurs=l) 
element defines the major product release string (as in .NET My Services Beta 1, and so on). 
The /system/systemVersion/version/productlmplementationName (anyURI minOccurs=l 
maxOccurs=l) element defines the class of the service to differentiate between different 
implementations. 

The /system/systemVersion/buildDate (dateTime minOccurs=l maxOccurs=l) 
element defines the date and time that the .NET My Services system was built. The time is in 
UTC (Z relative) form. The /systemVersion/buildDetails (minOccurs==l maxOccurs=l) 
element defmes details of the build including the machine that generated the build, the branch 
id of the software that contributed to the build, the type of build (chk/fi:e), and if the build was 
generated by an official build release process. 
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The /systelIl/systemVersion^uildDetails/@machine (string minOccurs=0 
maxOccurs=l) attribute specifies the machine that generated the build. The 
system/systemVersion/buildDetails/@branch (string minOccurs=0 maxOccurs=l) attribute 
specifies the software branch id for the source code that contributed to this build. The 
/system/systemVersion/buildDetails/@type (string minOccurs=0 maxOccurs=l) attribute 
specifies the type of build. A value ofchk indicates that this is a checked or debug build. A 
value of fire indicates that this is a retail build. The 

/system/systemVersion/buildDetails/@official (string minOccurs=0 maxOccurs=l) attribute 
indicates that the build was produced by an official build process (value of yes), or an 
unofficial process (value of no). 

The /system/roleMap (minOccurs=l maxOccurs=l) element encapsulates all the 
elements that make up a roleMap, which include document class relative roleTemplate, 
priority, name, method, and per-method scope. An individual roleTemplate defines the 
maximum scope of information, and the allowable methods used to access that information 
for each request mapped into the template. The /system/roleMap/@changeNumber 
(minOccurs=0 maxOccurs=l) changeNumber attribute is designed to facilitate caching of the 
element and its descendants. This attribute is assigned to this element by the .NET My 
Services system. The attribute is read-only to applications. Attempts to write this attribute 
are silently ignored. The /system/roleMap/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique JD assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest, Application software can override this ID generation by specifying the 



-31- 



useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/roleMap/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformid of the node. The /system/roleMap/scope 
(minOccurs=0 maxOccurs=unbounded) element defines a scope which may be referred to by 
roles within this roleMap to indicate what portions of the document are visible to this role for 
the specified method. 

The /system/roleMap/scope/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Nomially, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. The /system/roleMap/scope/name (string 
minOccurs=0 maxOccurs=raibounded) node includes the 

/system/roleMap/scope/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute, 
which is used to specify an ISO 639 language code or an ISO 3166 country code as described 
in RFC 1766 (wherein ISO stands for International Organization for Standardization and RFC 
stands for Request For Comment). The value of this attribute indicates the language type of 
the content within this element. The /system/roleMap/scope/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (ri^t to left), and Itr (left to right). 
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The /system/roleMap/scope/shape (mmOcciirs=l maxOccurs=l) comprises a shape 
that defines the node set that is visible through the document when operating through this 
shape element. The /system/roleMap/scope/shape/@base (string minOccurs=0 maxOccurs=l) 
attribute specifies the initial set of nodes visible through the shape. A value oft indicates that 
the shape is initialized to include all possible nodes relative to the shape that is currently in 
effect. For instance, each role defines a scope containing a shape. When defining a shape for 
a role, the value t indicates all possible nodes available in the specified document for this role. 
When defining a shape in an ACL entry, a value oft means all of the nodes visible in the 
shape for the computed role. When using a shape in a data language (e.g., query, insert, 
replace and so on) operation, a value of t indicates all of the possible nodes selected by the 
data language operation (relative to the ACL shape which itself is relative to the role's shape). 
The value nil indicates the opposite oft, which is the empty node set. Nodes from this set 
may then be included into the shape. 

The /system/roleMap/scope/shape/include (niinOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be included into the shape relative to the 
possible set of nodes indicated by the base attribute. The 

/system/roleMap/scope/shape/include/@select (string minOccurs=0 maxOccurs=l) item 
specifies an XPATH expression that selects a set of nodes relative to the extemally 
estabUshed context. The expression can never travel outside the node-set estabUshed by this 
extemally established current context. The expression may match zero or more nodes, and the 
operation manipulates all selected nodes. The minOccurs and maxOccurs attributes axQ 
optional and place restrictions and limitations on the number of nodes selected. 
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The /system/roleMap/scope/shape/exclude (minOccurs=0 maxOccurs=unbounded) 
element specifies the set of nodes that should be excluded from the shape relative to the 
possible set of nodes indicated by the base attribute. The 

/s>«tem/roleM^/scope/shape/exclude/@select (string minOccurs=0 maxOccurs=l) item 
5 specifies an XPATH expression that selects a set of nodes relative to the externally 

established context. The expression can never travel outside the node-set estabhshed by this 
externally established current context. The expression may match zero (0) or more nodes, and 
the operation manipulates all selected nodes. The minOccurs and maxOccurs attributes are 
optional and place restrictions and Umitations on the number of nodes selected. The 
1 0 /system/roleMap/roleTemplate (niinOccurs=0 maxOccurs=unbounded) element encapsulates 
the definition of a role. The attribute set for this element includes the document class that this 
roleTemplate refers to, the name of the roleTemplate, and the priority of the roleTemplate. 

The /system/roleMap/roleTemplate/@name (string minOccursN) maxOccurs=l) 
element specifies the name of the role. The /system/roleMap/roleTemplate/@priority (int 
1 5 minOccurs=0 maxOccurs=l) element specifies the priority of the roleTemplate which is used 
to select that actual roleTemplate when the role evaluation determines that the subject maps to 

multiple roleTemplates. 

The /system/roleMap/roleTemplate/fullDescription (string minOccurs=0 
maxOccurs=l) element contains a description of this role template which specifies the 
20 capabilities a caller will have when accessing information through this role. The 

/system/roleMap/roleTemplate/fullDescription/@xml:lang(minOccurs=lmaxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
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described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /systeni/roleMap/roleTemplate/fullDescription/@dir (string 
minOccurs=0 maxOccurs^l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /system/roleMap/roleTemplate/method (minOccurs=0 maxOccurs=unbounded) 
element specifies the methods available within this roleTemplate by name, and by scope. 
When a subject maps to a roleTemplate, the method in the request must match one of these 
elements for the message to continue to flow. If the method exists, the data available to the 
method is a function of the scope referenced by this method combined with an optional scope 
referenced by the role defined in the roleList. 

The /system/roleMap/roleTemplate/method/@name (string minOccurs=0 
maxOccurs=l) element specifies the name of the method. The 
/system/roleMap/roleTemplate/method/@scopeRef (string minOccurs=0 maxOccurs=l) 
attribute specifies the scope within this document that is in effect for this method. The 
/system/methodMap (minOccurs=l maxOccurs=l) element defines the methodMap. While in 
most cases, the roleMap section contains a definitive Ust of methods, these methods are likely 
to be scattered about the roleMap in various templates. This section contains the definitive 
non-duplicated list of methods available within the service. 

The /system/methodMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 
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The /system/methodMap/@id (minOccurs=0 maxOcciirs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. The /system/methodMap/@creator (string 
minOccurs=0 maxOccurs=l) attribute identifies the creator in terms of userld, appid, and 
platformid of the node. 

The /system/raethodMap/method (minOccurs=0 maxOccurs==unbounded) element 
defines a method that is available within this service. The 

/system/methodMap/method/@name (string minOccurs=0 maxOccurs=l) attribute specifies 
the name of a method available within the service. The /system/methodMap/method/{any} 
(minOccurs=0 maxOccurs=unbounded) provides for extensibility. The /system/schem^ap 
(minOccurs=l maxOccurs=l) element defines the various schema's that define the data 
structures and shape of information managed by this service. Each schema is defined by its 
namespace URI, its location, and a preferred namespace alias. 

The /system/schemaMap/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to apphcations. Attempts to write this attribute are silently ignored. 

The /system/schemaMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
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generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useChentlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/schemaMap/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/system/schemaMap/schema (minOccurs=0 maxOccurs=unbounded) element defines a 
schema which defines data-structures and the shape of information managed by this service. 
Multiple schema elements exist for each service, once for each logical grouping of 
information exposed by the service. The /system/schemaMap/schema/@namespace (anyURI 
minOccurs=0 maxOccurs=l) attribute specifies the namespace URI of this schema. The 
/system/schemaMap/schema/@schemaLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute specifies the location (in the form of a URI) of the resource containing schema. 
When a schema is reachable through a variety of URIs, one schema element will exist for each 
location. 

The /system/schemaMap/schema/@alias (string minOccurs=0 maxOccurs=l) 
attribute specifies the preferred aUas that should be used if possible when manipulating 
information covered by this schema in the context of this service. The 
/system/schemaMap/schema/ {any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibiUty. The /system/wsdlMap (minOccurs=l maxOccurs=l) element defines the 
wsdlMap for this service. This map includes the location of WSDL documents, DISCO 
documents, and WSIL documents for this web service. These documents are used by 
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applications to understand the format of messages that may be sent to the various services. 
The /s5^teni/wsdlMap/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to faciUtate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
appUcations. Attempts to write this attribute are silently ignored. 

The /system/wsdlMap/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
JD assigned to this element by .NET My Services. Nomially, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. The /system/wsdDV[ap/@creator (string minOccurs=0 
maxOccurs==I) attribute identifies the creator in terms of userld, appid, and platformid of the 
node. 

The /system/wsdlMap/wsdl (minOccurs=0 maxOccurs=unbounded) element is used 
to specify the location of a WSDL file for this service. Multiple entries may exist pointing to 
the same file hosted in multiple locations, or to variations on the content within the WSDL 
files. 

The /system/wsdlMap/wsdl/@wsdlLocation (anyURI minOccurs=0 maxOccurs=l) 
attribute is a URI that specifies the location of the WSDL file. The 

/system/wsdlMap/wsdl/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibility. 
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The /system/wsdlMap/disco (minOccurs=0 maxOccurs=imbounded) element is used 
to specify the location of a DISCO (web-services discovery) file for this service. Multiple 
entries may exist pointing to the same file hosted in multiple locations, or to variations on the 
content within the DISCO files. The /system/wsdlMap/disco/@discoLocation (anyURI 
5 minOccurs=0 maxOccurs=l) attribute is a URI that specifies the location of the DISCO file. 
The /system/wsdlMap/disco/ {any} (minOccurs=0 maxOccurs=unbounded) provides 
extensibility. 

The /system/wsdlMap/wsil (minOccurs=0 maxOcciu:s=unbounded) element is used to 
specify the location of a WSIL file for this service. Multiple entries may exist pointing to the 
J' -1 10 same file hosted in multiple locations, or to variations on the content within the WSIL files. 
%J The /systeni/wsdlMap/wsil/@wsilLocation (anyURI minOccurs=0 maxOccurs=l) attribute is 

.Mi 

a URI that specifies the location of the WSIL file. The /system/wsdlMap/wsil/{any} 
. (minOccurs=0 maxOccurs=unbounded) provides extensibility. 

m 

Q 15 Content Document Subscriptions 

Each of the core services content documents described below (other than myServices, 
at present) include a subscription node that essentially takes action when items change, such 
as to propagate information about the change to other services. For simplicity and to avoid 
redundancy, the meaning of the subscription elements and attributes common to the content 
20 documents are described once, rather than for each service. The following table sets forth the 
subscription elements and attributes common to the core services content documents: 
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: (other service content) 

<in:subscription changeNmnber ='\>/' id-',.." creator="...">o.unbounded 

<hs:trigger select^"...'' mode="..." baseChangeNumber=" ..">i..i</hs:trigger> 
<hs:expiresAt>o..i</hs:expiresAt> 
<hs:contexturi="...">i..i /fl»j;;</hs:context> 
<hs:to>i..i</hs:to> 
</in:subscription> 

: (other service content) 



The /*actual service name*/subscription (minOccurs=0 maxOccurs=unbounded) 
element defines a subscription node that is designed to be an xdbiblue node which when 
placed in a content document causes a subscription to be registered, (wherein as used herein, 
the string "*actual service name*" referred to in this section can be replaced by an appropriate 
service name, e.g., "myAppHcationSettings" or "myContacts" or "myWallet" and so forth). A 
subscription contains a trigger element which selects a scope of coverage. When items that 
are under this scope of coverage change, a subscriptionResponse message is generated and 
sent to the specified destination address. 

The /*actual service name*/subscription/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate cachmg of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system, and 
the attribute is read-only to applications; attempts to write this attribute are silently ignored. 
The /*actual service name*/subscription/@id (minOccurs=0 maxOccurs==l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
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Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useCUentlds attribute in the request message. Once an K) is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /^actual service name*/subscription/@creator (string minOccurs^O maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
/*actual service name*/subscription/trigger (minOccurs=l maxOccurs=l) includes the 
/*actual service name*/subscription/trigger/@select (string minOccurs=0 maxOccurs==l) item, 
which specifies an XPATH expression that specifies the nodes that are to be selected and 
watched for changes. The selection may only select xdb:blue nodes, as described above. A s 
changes in this node set occur, they trigger the generation of a subscription message. These 
messages are then sent to the SOAP receiver hsted in the "to" element. 

The /*actual service name*/subscription/trigger/@mode (string minOccurs=0 
maxOccurs=l) attribute specifies whether or not the content of the changes that triggered the 
subscription are delivered in the subscription message, or if the message simply indicates that 
something changed under the trigger. The attribute may comprise includeData, namely that 
the data that changed and caused the subscription to trigger is included in the subscription 
message. Note that deleted nodes are specified by their id, not by value, Altematively the 
attribute may comprise excludeData, whereby the data that changed, causing the subscription 
to trigger, is not included in the subscription message. 

The /*actual service name*/subscription/trigger/@baseChangeNumber (minOccurs=0 
maxOccurs=l) attribute specifies the changeNumber value that the trigger is relative to. All 
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changes between the specified change number, and the current state of the document relative 
to the selection are transmitted as subscription messages. This allows a client application to 
estabhsh a subscription relative to some baseline. As in changeQuery, if the 
baseChangeNumber is way out of date relative to the current state of the document, and the 
5 service can not supply the changes in the subscription message, the subscription insert is 
rejected. A value of zero (0) means that the current values of the selected nodes are 
transmitted in the subscription message. 

The /*actual service name*/subscription/expiresAt (dateTime minOccurs=0 
maxOccurs=l) optional element specifies an absolute time after which the subscription is no 
ii 3 10 longer active. The subscription node is automatically removed when the subscription expires. 

If this element is missing, the subscription does not expire. The /*actual service 
7^ name*/subscription/context (minOccurs=l maxOccurs=l) element retums the context element 
V; from the original subscription. AppUcations should use this element to correlate the 

□ subscription response with one of their subscriptions. 

j y 

|,y 1 5 The /*actual service name*/subscription/context/@uri (anyURI minOccurs=0 

U 

maxOccurs=l) attribute specifies the URI value chosen by the subscriber that is associated 
with this subscription. The /*actual service name*/subscription/context/{any} (minOccurs=0 
maxOccurs=nxnbounded) including the /*actual service name*/subscription/to (anyURI 
minOccurs==l maxOccurs=l) attribute specifies the location that is to receive the subscription 
20 message. The value of this element may be hs:myAlerts, whereby this URI indicates that 
generated subscription messages are to be delivered inside the body of a notification and 
delivered to the default .NET Alerts service of the creator. Alternatively, the value may be 
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protocol://service, whereby this URI indicates that generated subscription messages are 
delivered to the specified service at the domain of the creator's platformld. For example, a 
platformid indicating microsoft.com, and a value in this element of 
http://subscriptionResponse would cause delivery of the subscription message to 
5 http://subscriptionResponse.microsoft.com, If this value is not specified, then the subscription 
message is delivered as a notification to the "creator's" .NET Alerts service. The /*actual 
service name*/{any} (minOccurs=0 maxOccurs=unboimded) field allows for extensibility. 



CORE SERVICE SCHEMAS 
□10 A number of the services 301-3 15 (FIG. 2) are referred to as core services, which 

y 

i. , I. 

Q employ schemas to manage access to the data that most users will likely need. Other services, 

m 

m referred to as extended services 216, will also employ schemas in the same manner, but are 
ii more likely to be desirable to certain users and not others. Examples of extended schemas 
O include services such as myPortfolio, myPhotos, myTravel, myMusic, myMovies, myTV, 
j. J 15 myWishUst, mySchool, myGroceries, myNews, mySports, myTopScores and so on. As will 
be understood, although the present invention will focus on the core schemas, the present 
invention is not limited to any schema in particular, but rather is directed to all such schemas. 
For purposes of organization, the various services and schemas will be described 
alphabetically by service name, with the one exception being that the "myServices" service 
20 will be described first, since applications typically call the myServices service first, in order to 
communicate with the other services. Note that this is only one exemplary set of core 
services, and that other core services implementations may include different services, a 
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different combination of these services (i.e. a subset), and/or additional services which may be 
considered as "core" services. Also, note that the extended services need not be provided by 
the provider of the core services, e.g., there may be a number of users who subscribe to one 
companies core services but only subscribe to third party extended services. Likewise, there 
5 may be a number of services providers who provide core services or extended services but not 
both. Thus, it should be imderstood that a core services provider may also provides extended 
services, or providers of core or extended services, or both, may be different entities. 



mvServices 

10 The myServices schema is an XML schema that describes the Ust of available other 

J myServices for a given identity (i.e. person, organization, business). The myServices schema 
i!n essentially serves a directory of what and where each of the myServices logically resides, as 

.i SSj 

well as additional information used to identify the service in the use of general 

lif; communication. Note that the myServices service that provides the URI (and other needed 

! y 

Q 15 information) should not be confused with the general concept of ".NET My Services" as 
described above. 

Issuing a query request to myServices is part of every application's initial 
responsibility to figure out where a desired service resides. More particularly, the myServices 
service 314 (FIG. 3) generally allows an application program to obtain the information (e.g., 
20 including a URI) needed to connect to aaother service. It should be noted that there are 
multiple instances of each such service, e.g., a provider such as MSN.com will have a 
different mylnbox service instance than XYZ.com will have for its mylnbox service, and 
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indeed a single provider may have multiple instances of a service. Moreover, a single user 
may have email accounts at both MSN.com and XYZ.com, and different users may use the 
same apphcation program to communicate with possibly many other instances of the mylnbox 
service. As a result, an application program normally does not have URIs hard coded therein 
5 or initially cached for the many possible instances of the various services, so the apphcation 
program contacts the myServices service 314 to determine the URI of a service for the current 
user. The apphcation will of course know or otherwise be able to determine the URI of the 
myServices service 314, The information retumed by the myServices service 314 can be 
cached thereafter, whereby the application can talk directly to the service desired. However, 

[i ^ 

i!S 10 at any point in time, a given service may respond to the application with a 'not foxmd here' 

\trSs 

%J type of error, which the application should respond to by again contacting the myServices 

ffi 

service, as the user's service may have been moved. 

!' '"'5 

An application program's query to myServices may result in multiple sets of 

m information (e.g., multiple XML documents) being retumed. For example, a user may have 

i U 

i;3 15 different email addresses and get information on different mylnbox services retumed in 

response to a single query. An apphcation that can deal with such multiple sets, such as by 
prompting the user to select one, can use some or all of the information retumed. One of the 
sets of information may be marked as a primary set, whereby appUcations that can only work 
with a single set may simply select the primary. 
20 Thus, the apphcation program 400 queries the myServices service 314, represented in 

FIG. 5A by the arrow labeled with ckcled numeral one (1). In addition to the URI of the 
desired service instance, (e.g., the MyCalendar service 303), in order to communicate with the 
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service 303 the application program 400 needs an identity license, for example a Kerberos 
ticket that identifies the user, plication and credential type. To this end, the myServices 
service 314 returns the URI , a service principal name (spn), and realm information that 
corresponds to a Kerberos domain controller (KDC) 500, as represented in FIG. 5A by the 
arrow labeled with circled numeral two (2). The application program 400 uses the spn to 
obtain the identity license fi-om the KDC 500 based on the reahn information, as represented 
via the arrows labeled three (3) and four (4), wherein a KDC 500 issues tickets for services in 
a particular realm 502. The application program 500 may then properly communicate with the 
myCalendar service 303 (arrow labeled five (5)). 

In an alternative implementation, represented in FIG. 5B, for efficiency, an instance of 
the myServices service 314 maybe part of a reahn 504 having a KDC 506. In response to the 
query (the arrow labeled one (1)), if the reahn that the myServices service is part of is the 
same as the realm tiiat would be returned to the application program 400, the myServices 
service 314 will instead automatically obtain the ticket for the application program 400, as 
represented in FIG. 5B via the arrows labeled two (2) and three (3). The license ticket is then 
directly returned, (arrow labeled four (4)), whereby the ^plication program 500 may then 
properly communicate with the myCalendar service 303 (arrow labeled five (5)). Note that it 
is typically far faster for the myServices service to communicate with the KDC in its realm 
(e.g., in the same datacenter) than for an appUcation program to do so over an Internet 
connection. It should be noted that a myServices instance can also be associated with 
multiple KDCs, and does not have to belong to any one reahn. For example, a myServices 
service may be able to communicate vdth a Passport KDC, an MSN.com KDC, a hotmail.com 
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KDC, and so forth. When an application program query results in a realm that corresponds to 
one of these KDCs, the myServices service can obtain the license ticket directly, as described 
above. 

In most cases, the myServices entry serves as the definitive information for a given 
user and the service information. However, one possibiUty is that a myServices instance will 
not know the specifics of a particular user's needed information, e.g., the desired service's 
URI, realm and/or spn. In such an event, the myServices instance can refer the application 
program to another myServices instance by returning referral information (in a refer field) to 
the application program in response to the query. To this end, when a <refer> tag is found 
within a service entry, this means that the entry is a referral, and the <to> element actually 
points to another second tier myServices service. This capabiUty is important for the ability to 
distribute the lookup information instead of having one centralized logical point of failure and 
updates. Ultimately the application program will obtain the address and other information of 
the desired .NET MyServices service. Note that it is possible for a response to include a 
referral and also include a license ticket, since a myServices instance may be connected to the 
appropriate KDC, but not have the URI of the desired service. 

myServices / Roles 

The myServices service controls access by using the roleTemplates, rtO, rtl, rt2, rt3, 
and rt99, using the following scopes: 

scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 
<hs:shape base=t> 
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</hs:shape> 
</hs:scope> 

scope onlySelfEIements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 
<hs:include selecW/* [@creatop=' $callerld' ]/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scopeid=b7fi)5a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base=nil> 
<hs:mcludeselect=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8f^ 
<hs:shape base=nil> 
<hs:include select=//*[cat/@re^*hs:public']/> 
<hs:mclude select=//subscription[@creator=*$callerId']/> 
</hs:shape> 
</hs:scope> 

The myServices rolcTemplate rtO role gives give complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myServices service through that method while mapped to this 
roleTemplate. 



TABLE -my S ervices roleTemplate rtO 



{method 


scope/name 


[query 


allElements j 


jinsert 


allElements j 


[replace 


allElements j 


jdelete 


allElements 
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The myServices roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content document. Applications may create nodes in any location, but may only 
change/replace, or delete nodes that they created. The following table illustrates the available 
methods and the scope in effect when accessing the myServices service through that method 
while mapped to this roleTemplate: 



U 10 

fU 

ru 



15 



method 


scope/name J 


Query 


allElements ; 


jlnsert 


onlySelfElementsi 


IReplace 


onlySelfElements 


IBelete 


onlySelfElements 



The myServices roleTemplate rt2 gives complete read access to all information within 
the content document of the service being protected through this roleTemplate. Applications 
mapping to this role have very limited write access and are only able to create and manipulate 
their own subscription nodes^ The following table illustrates the available methods and the 
scope in effect when accessing the myServices service through that method while mapped to 
this roleTemplate. 

TABLE - myServices roleTemplate rt2 



method 



scope/name 



query 



insert 



ireplace 



allElements 



onlySelfSubscriptionElenients 



onlySelfSubscrip tionElements 
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□ 



The myServices roleTemplate rt3 gives limited read access to information witiiin the 
content document that is categorized as "public." The following table illustrates the available 
methods and the scope in effect when accessing the myServices service through that method 
while mapped to this roleTemplate: 



jmethod 


scope/name 


Iquery 


onlyPublicElementsi 



The myServices roleTemplate rt99 blocks access to the content document. Note that 

^ 3 lack of a role in the roleList has the same effect as assigning someone to rt99. The following 

□ 

!;1 10 table ilhistrates that there are no available methods and the scope in effect when accessing the 

m myServices service through that method while mapped to this roleTemplate (note that in other 

UP 

services described herein, such an empty table will not be repeated): 
TABLE ■ myServic es roleTemplate rt99 



methodiscope/name 



15 myServices / Content 

The content document is an identity centric document. It's content and meaning is a 
function of the puid used to address the service. Accessing the document is controlled by the 
associated roleList document. 

This schema outline illustrates the layout and meaning of the information found in the 
20 content document for the myServices service: 



<m:.myServices changeNumber= "..." instanceld="..." 
xmlns:m=^^http://schemas.microsoft.com/hs/2001/10/myServices" 
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xmlns:hs="http://schemas.microsoft.comyhs/2001/10/core">i..i 

<m:service name- '..." changeNmnber^ "..." id-'..." creator="...">o..unbounded 

<m:catref="...">o..unbounded</m:cat> 

<m:key puid="..." instance="..." cluster="...">o..i</m:key> 

<m:refer>o..i</m:refer> 

<in:to>i..i</m:to> 

<m:spn>i..i</m:spn> 

<m:rea]in>i..i</m:realm> 

{any} 
</iii:service> 
{any} 
</m:.myServices> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is requked or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myServices (minOccurs=l maxOccurs=l) element encapsulates tiie content 
document for the service. The /myServices/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myServices/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a 
unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 
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The /myServices/service (niinOccurs=0 maxOcciirs=unbounded) node includes a 
/myServices/service/@name (string minOccurs=0 maxOccurs==l) element which contains the 
name of the service being accessed by this request message. For example, to access the .NET 
Profile service, this attribute will have the value "myProfile". 

The /myServices/service/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myServices/service/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest, Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myServices/service/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. 

The /myServices/service/cat (minOccurs=0 maxOccurs=unbounded) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 
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The /myServices/seiYice/cat/(^ef (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^>) element using the rules outlined below in the 
myCategories section of the present application. 

The /myServices/service/key (minOccurs==0 maxOccurs=l) element specifies key 
information used to zoom in on a document being manipulated. This information includes the 
identifier (puid) of the entity that owns the document, the instance identifier of the document, 
and the cluster or partition key used to locate the machine resources that hold the document 

hi certain situations, a client will want to send the same message to a number of 
instances of a particular service. In order to do this, the chent may repeat this element 
multiple times. The cluster attributes in all elements must match each other, but the puid and 
instance attributes may differ. A unique response message is generated for each key specified. 
The entire contents of this element come fi-om the myServices service 314 (FIG. 3). 

The /myServices/service/key/@puid (string minOccurs=0 maxOccurs=l) element 
specifies the PUID of the entity that "owns" the service being accessed. In the case of a 
"myProfile" service, this element is equivalent to the "my". The puid may be used to 
automatically connect to another set of information for the user. By way of example, consider 
a user with a two puids, such as a work puid and a home puid. The puid field can contain the 
user's other puid, which allows one or more instances of a desired service to operate as if the 
user connected with both. 

The /myServices/service/key/@instance (string minOcciars=0 maxOccurs=l) element 
specifies the particular instance of the service for this id being accessed. For example, if a 
given id is provisioned with multiple .NET Calendar documents on the same cluster and in the 
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same data center, the documents would differ only by this value. In other words, while 
services are generally thought of as constructing a document per user identifier, in actuality 
more than one instance may exist for a given user. For example, a user, with the same puid, 
may have personal calendar, a work calendar, a top secret calendar, and so forth, each of 
5 which corresponds to an instance. The instance id identifies fi-om which instance a user wants 
to access data. 

The /myServices/service/key/@cluster (string mmOccurs=0 maxOccurs=l) element 
specifies information used by the .NET My Services system to locate the document on a 
particular back-end server or database. It is used as the virtual partition key for the document 
f 10 being addressed. This technique is preferable to computing this partition key based on some 



( n hash of the puid/instance. If the data is later moved to another back-end server or database, 
Q the application will need to go back to myServices to obtain its new location. 



m 

m 



The /myServices/service/refer (string minOccurs=0 maxOccurs=l) element specifies 
whether the fields below are for a referral, as described above. 



Q 

!^ 15 The /myServices/service/to (string minOccurs=l maxOccurs=l) element specifies the 

destination URI (typically a URL), e.g., either of the desired service or of a referral address. 

The /myServices/service/spn (string minOccurs=l maxOccurs=l) element specifies 
the spn needed that maybe needed to obtain a license fi'om a KDC, as described above with 
reference to FIG. 5A. The /myServices/service/reahn (string minOccurs=l maxOccurs=l) 
20 element specifies the authentication realm for the spn in question, as also described above. 
The /myServices/service/{any} (minOccurs=0 maxOccurs=unbounded) and 
/myServices/ {any} (minOccurs=0 maxOccurs=unbo\mded) fields allow extensibility of the 
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myServices service. For example, if a license was returned directly by the myServices service 
as described above with respect to FIG. 5B, then the license data may be returned in an {any} 
field. Alternatively, a dedicated <license> field may be built into the myServices content 
document. 

5 

myServices /System 

The myServices system document includes the set of base items common to each of 
the .NET My Services, as described above. At present, the myServices system document is 
U not optionally extended. Hereinafter, only services with system documents having extended 
P 10 items will include such a separate system section, although it should be understood that each 

j: sSs 

^ service has a system document corresponding to at least the base system document. 

i 

M myAlerts 

□ 

} Jf The Microsoft® .NET Alerts service, generally referred to as myAlerts, provides a 

12' 1 5 single point where short messages can be sent to a specific user and transparently routed to 
that user's apphcations or devices. This particular service uses an XML schema to describe 
Alerts, and the methods by which Alerts can be sent and received. In general, the myAlerts 
service processes alerts (also referred to as notifications and/or events). 

In keeping with the present invention, an alert is defined as embeddable XML, 
20 specifying both standard schema and extensible problem-domain schema, using the problem- 
domain schema as alert typing. The standard schema is generally directed to conveying alerts, 
regardless of what the alert is trying to convey. The problem-domain schema extension is 



-55- 



used in a dynamically programmable Alert processing mechanism to control alert routing. 
Like other .NET My Services, .NET Alerts is designed to service the user instead of a 
particular device or application. Although alerts are posted to a single location, the messages 
are transparently routed to one or more of the user's appUcations or devices. The logic for 
5 deciding how, where, and when a message is delivered can be customized to meet the needs of 
a particular user, device, or application. 

The myAlerts service includes mechanisms to deliver alerts, comprising a basic model 
mechanism that provides the baseline functionality of sending and receiving alerts. A streams 
model mechanism includes more robust features, such as filtering, buffering, and persistence, 
nlO as well as more refined control over the routing of alerts. 

'"■ 4 As used herein, a client is any entity that can issue an XMI request to the .NET Alerts 

service. Clients can send or receive alerts, wherein an alert typically comprises a short XML 
l ^ message deUvered to one or more users by .NET Alerts. A receiver is a .NET My Services 
j y user who has one or more appUcations that can receive alerts. Such an application is referred 

i:3 15 to herein as a user Agent. A user Agent includes any code on any device that can communicate 

< . 

with .NET Alerts. 

The myAlerts service provides a variety of ways to communicate with userAgents. 
For example, as generally represented in FIG. 7, a sender 700 may send an alert 702 by issuing 
an XMI request to the myAlerts service 301. The sender 700 can send alerts to the sender's 
20 own user, or to another user. Senders and most userAgents are clients because they issue 
XMI requests to the myAlerts service to send or receive alerts. Because myAlerts supports 
non-XMI protocols to deUver alerts to userAgents, some userAgents are not cUents. 
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UserAgents 716-718 create connections 712-714, respectively, to receive alerts. Each 
connection (e.g., 712) has a query that selects which alerts the connection 712 will forward to 
its respective userAgent 716. The connection 712 will use a particular protocol to deliver 
alerts to the userAgent 716; different connection types may provide different protocols for a 
userAgent. As the .NET Alerts service receives alerts, it routes them to zero or more 
connections, depending on the queries for each connection. 

To send an alert 702, a client sender 700 issues a notify method request to a user's 
myAlerts service 301. To receive alerts, a userAgent (e.g., 716) issues an insert method 
request to create a connection 716 in the myAlerts content document, and then processes the 
resulting connection protocol to receive incoming alerts. Different connection types can 
support different alerts and userAgent protocols (for example, SOAP/XMI over HTTP, 
TCP/DIME, and UDP), and can also include SIP or other non-XMI protocols. Connections 
generally fall into Push Connections, wherein the myAlerts service proactively pushes an alert 
to a userAgent, or Pull Connections, wherein the userAgent proactively pulls an alert from the 
myAlerts service. This requires some alert buffering. 

In general , each alert 702 is a snippet of XML passed to and from the myAlerts 
service 301 embedded within XMI method request and response packets. The hfetime (and 
position) of an alert is transitory. Therefore, alerts are not part of the user content document. 
Alerts are proactively sent to the myAlerts service or to userAgents with the notify method, 
described below. Alerts are proactively pulled from the myAlerts service with the poll 
method, also described below. 
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Argots 703 are XML blobs (e.g., strongly-named {any} fields) that may be placed in 
an alert to convey problem domain-specific data. The outer element name defines the argot; 
the inner contents of the argot are opaque to general myAlerts processing. At present, argots 
may be represented formally and informally. An argot is formally declared through an outer 
argot element, and its name is specified through the argotURI attribute. The actual content of 
the argot is specified in sub-elements. The formal representation of argots may change to the 
informal representation in fixture versions. Informally declared argots are simply declared as 
an XML element. In this case, the argot name is the name of that element. Such an argot can 
have sub-elements, as appropriate. 

The myAlerts service expects informal argots within the contents element of an alert. 
The xpQuery element for both streams and connections defines a query against the argot 
names within the contents element. For example, an xpQuery value of "humanReadable" in a 
connection causes that connection to get only alerts that contain the humanReadable argot in 
their contents. To match all argots, an asterisk ("*") may be specified in the xpQuery value. 

The myAlerts service expects formal argots in some of the stream and connection 
document methods. For example, the push connection requires the 
pushConnectionParameters formal argot in insert and replace methods, and generates it for 
query methods. 

As generally represented in FIG. 7, a streams model is also provided. Unlike the basic 
model, the streams model provides a mechanism to filter, buffer, persist, or inteUigently 
control the routing of alerts. A stream of alerts is a set of alerts that match an argot query. 
The argot query specifies a relation of argot types; an alert is in the stream if it contains argots 
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that match the stream query. To include alerts in a stream, an asterisk ("*") may be used, or a 
set of argot types (for example, "humanReadable") can be specified to include a subset. 

A stream (e.g., 705) is an object inside a user's myAlerts service 301 that defines and 
manages a stream of alerts as they are routed to the user's connections. Clients can create and 
provision one or more streams to control the alert routing for a user. A user may have 
multiple streams 705-707 to control different streams of alerts. Multiple streams are 
supported because a user will often receive different types of alerts, each requiring its own 
filtering, buffering, and so on. For example, the myAlerts service 301 may focus on human- 
oriented alerts to implement a stream that controls alerts containing the humanReadable argot. 
Other services or appUcations will defme their own argots, and will want to control the 
processing of their alerts. 

Clients create, manage, and delete streams through XMI requests to a user's .NET 
Alerts content document. Generally, a stream operates in four steps: 

1 . Instantiate - the stream is instantiated firom a stream class and provisioned to 
control its behavior. 

2. Select - the stream will select the alerts to process as they arrive. 

3. Process - the stream processes its selected alerts, 

4. Route - the stream routes its alerts to other streams or to connections for delivery 
to one or more userAgents. 

These steps are formalized in three objects inside the alert routing, namely streamFork 
704, stream (e.g., the stream 706) and connectionFork (710). When an alert 702 is received 
by the myAlerts service 301, the streamFork 704 decides the order in which to invoke streams 
705-707 on the alert 702. When invoked, each stream will determine whether to handle the 
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alert and whether to continue or stop the streamFork processing. A stream (e.g., the stream 
706) can handle or ignore an alert, and can also allow or inhibit later streams from handUng 
the alert. 

Each of the streams 705-707 then applies its processing algorithm and state to the 
alCTts they handle. A stream can reroute the alert to other stareams by continuing or restarting 
the StreamFork process. A stream can deliver an alert by passing it on to the connections 
through the connectionFork 710. 

The connectionFork 710 controls communication between streams and connections 
712-714, processing and optimizing execution of tiie connection queries to match alerts to the 
appropriate connections. Conceptually, as represented in FIG. 7, alerts (e.g., the alert 702) 
moves forward from the sender 700, through the streamFork 704, through zero or more 
streams 705-707, through the connectionFork 710, through zero or more connections 712-714, 
to connected userAgents 716-718. Streams 705-707 can push alerts to connections 712-714 
or connections 712-714 can pull alerts from sfreams 705-707. This will match the type of 
connections (that is, push or pull). 

Stream types provide different alert handUng algorithms. Five possible stream 
capabilities includes: 

1. Simple Stream - selects a set of alerts and immediately passes them to any/all 
connections. This is the default stream for myAlerts and is always implemented by 
the StreamFork. It provides no buffering; alerts are immediately delivered through 
existing connections and then discarded. When they are not connected, userAgents 
miss all alerts. 

2. Buffering Stream - selects a subset of alerts and buffers them for some period of 
time. Alerts are passed to a connection when the connection can process the alert. 
Stream buffering allows a connection to deliver alerts received before the 
connection was created or across delays and failures in the connection's protocol. 
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3. Privacy Stream - selects and j&lters a subset of alerts according to a set of privacy 
or safety rules. The stream will choose to discard or deliver an alert based on its 
rules. Typically, a privacy stream will take sole possession of its subset of alerts. 

4. Routing Stream - selects a subset of alerts and changes their routing, controlling 
which succeeding streams or connections will process the alert. Routing streams 
can insert or remove alerts from the alert streams. 

5. Extemal Stream - delegates the actual stream algorithm and state to an object 
extemal to the myAlerts provider. The extemal stream type specifies and 
implements an XMI appUcation programming interface (API) for the extemal 
object. 

The myAlerts architecture declares the ordering and non-ordering of alert deUvery 
through a connection. However, alert buffering, multiple streams, and intra-user federation 
can make it difficult to guarantee ordering, and arbitrary rerouting of alerts by routing streams 
can make ordering impossible. A virtual stream is the aggregate set of alerts delivered 
through a particular connection. The order in a virtual stream will be defined by the set of 
streams contributing alerts to the virtual stream. Simple, buffering, and privacy streams are 
required to maintain a standard ordering of oldest to newest alerts in a virtual stream. Routing 
and extemal streams are also required to maintain that order. Alerts that are inserted into the 
stream need to be new; an old alert cannot be reinserted out of order or multiple times. 

One implementation of myAlerts provides a streamDefault stream class, which always 
exists and is not reflected in the user's content document, and a streamBuffer stream class. 
This stream will buffer up to one-hundred of the alerts it selects in memory. Note the number 
one-hundred is arbitrary, and was just selected as a suitable number for this implementation. 

Two connection classes are implemented in one current implementation of myAlerts, 
namely a pushConnection, wherein the connection will push an alert to an URL by issuing an 
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XMI notify method request, and a puUConnection, wherein the userAgent will issue XMI poll 
method requests to the connection to retrieve alerts. 

The alert schema contains both standard and problem-domain specific portions. The 
present invention types the problem-domain portions as argots and allows that typing to define 
the essential semantic naming shared between alert senders and receivers. 

The schema for the alert processing mechanism contains both stream objects which 
control alert processing within our service and connection objects which control delivery and 
protocol to extemal user agents. Both types of objects select and process alerts based on the 
argots contained in each alert, through the argotQuery element that specifies a standing query 
against received and persisted alerts. 

In addition, new methods are provided, described below, including: 

1 . Noti^ - to transmit one or more alerts from a sender to a receiver 

2. Poll ~ for a user agent to pull one or more alerts through a connection fi-om our 
service 

3. Route - to perform complex and privileged routing within our service 

4. Do - to request a stream or connection object to perform an action 

myAlerts/Roles 

The myAlerts service controls access by using the rtO, rt3 and rt99 roleTemplates, 
using the following scopes: 
scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 
<hs:shape base=t> 
</hs:shape> 



"62- 



</hs:scope> 

scope onlySelfEIements 

<hs:scope id=al 59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 
<hs:include select=//*[@creator='$callerId']/> 

</hs:shape> 
<;/hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<lis:shape base=ml> 
<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8f> 
<hs:shape base=nil> 

<hs:include select=//*[cat/@ref='hs:public']/> 
<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 



The myAlerts roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myAlerts service through that method while mapped to this roleTemplate: 



TABLE - myAlerts roleTemplate rtO 



method 


scope/namej 


query 


allElements 


insert 


allElements 


replace 


allElements 


delete 


allElements 


fupdate 


allElements ; 
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update 


allElements 1 


notify 


allElements ; 


poll 


allElements i 



The myAlerts roleTemplate rt3 role gives limited read access to information within the 
content document that is categorized as "public". Applications mapping to this role have very 
limited write access and are only able to create and manipulate their own subscription nodes. 
The following table illustrates the available methods and the scope in effect when accessing 
the myAlerts service through that method while mapped to this roleTemplate: 

TABLE - myAlerts roleTemplate rt3 



method 


scope/name 


query 


onlyPublicElementsI 


Notify 


allElements 1 



The myAlerts roleTemplate rt99 blocks access to the content document. Note that lack 
of a role in the roleList has the same effect as assigning someone to rt99. 
mvAlerts /notification 

Each alert comprises XML embedded within an XMI method packet or privately 
stored by the .NET Alerts service. The following is the structure of an alert: 
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<m:notification id=",.." 
xmlns:m-1ittp://schemas.microsoftxom/hs/2001/10/m 
xmlns:hs-Tit1p://schemas,microsoftxoni/hs/2001/10/core'^ ..unbounded 
<m:from>i..i 
<m:identityHeader type="...">o..i 

<m:onBehalfOfUser>i ..i</m:onBehalfOfUser> 
<m:licenseHolder>i..i</m:licenseHolder> 
<m:platformId>i„i</m:platfonnId> 
<m:identityHeader> 

<m:expiresAt ttl="..." onDate=",.;' replace="...">o..i</m:expiresAt> 

<m:acknowledge>o..i</m:acknowledge> 

<m:category id- \ ..">o..i</m:category> 
</m:from> 
<m:to>o..i 

<m:originalUser>o..i</m:originalUser> 
<ym:to> 

<m:contents>L.i {any}</m:contents> 
<m:routing>i„i 

<m:timestamp>o..i</m:timestamp> 

<m:hops>o..i</m:hops> 
</m:routing> 
</m:notification> 



The /notification (minOccurs=0 maxOccurs=unbounded) provides for zero or more 
alerts in the buffer of the streamBuffer stream. The /notification/@id (string minOccurs==0 
maxOccurs=l) is an identifier of the alert (notification), while the /notification/from 
(minOccurs=l maxOccurs=l) tag contains data from the sender, including sender 
authentication as well as preferences and requests from the sender. 

The /notification/from/identityHeader (minOccurs=0 maxOccurs=l) includes 
/notification/from/identityHeader/@type (string minOccurs=0 maxOccurs=l) and 
/notification/from/identityHeader/onBehalfOfUser (minOccurs=l maxOccurs=l). The 
uuidType is used to specify a universally unique identifier (UUID). The 
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/notification/firom/identityHeader/licenseHolder (minOccurs=l maxOccurs=l) uuidType is 
used to specify a universally unique identifier (UUID). 

The /notification/from/identityHeader/platformId (minOccurs=l maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUID). The 
5 /notification/fi-om/expiresAt (string minOccurs=0 maxOccurs=l ) is directed to expiration time 
of an alert, including /notification/fix)m/expiresAt/@ttl (string minOccurs=0 maxOccurs=l), 
/notification/fi-om/expiresAt/@onDate (string minOccurs=0 maxOccurs=l) and 
/notification/from/expiresAt/@replace (string minOccurs=0 maxOccurs=l). 
\.A The /notification/from/acknowledge (string minOccurs=0 maxOccurs=l) field 

□ 1 0 contains information related to acknowledging the alert, while /notification/from/category 
li (minOccurs=0 maxOccurs=l) and /notification/froni/category/@id (string minOccurs=0 

;* 7*!: 

'ft maxOccurs=l) contains category information. 

i 4 The /notification/to (minOccurs=0 maxOccurs=l) tag contains the data pertaining to 

b 

i U the receiver. This data can be set by the sender or by any processing/routing agent between 
P 15 the sender and the receiver. The /notification/to/originalUser (minOccurs-0 maxOccurs=l) 

if sis 

element defines the original receiver of the alert. A routing agent may change (forward or fan 
out) an alert to other receivers. If so, it should add this element to the alert. 

The /notification/contents (minOccurs=l maxOccurs=l) element contains the problem 
domain-specific data to be conveyed to the receiver. Each child element of the contents 
20 element is an argot, a problem domain-specific strongly-typed XML blob. Streams and 
connections query against tibie element names of these blobs when selecting alerts they will 
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process. The /notification/contents/ {any} (minOcciirs=0 maxOccurs=unbounded) contains 
the argot data. 

The /notification/routing (minOccurs=l maxOccurs=l) tag contains any routing data 
inserted by the myAlerts routing process. The /notification/routmg/timestamp (string 
5 minOccurs=0 maxOccurs=l) element contains the timestamp of when the alert was received 
by the myAlerts service. The /notification/routing/hops (string minOccurs=0 maxOccurs=l) 
element defines the actors that have processed llie alert to date. This data can be used by the 
myAlerts service to recognize and stop infinite loops. 



'.310 mvAlerts /content 



<m:myAlerts changeNumber="..." instanceld-*..." 
xmlns:m="http://schemas.microsoft.com/hs/200 1 / 1 0/myAlerts" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:streaiii changeNumber= ''..." id="..." creator="...''>i ambounded 

<m:class>i..i</m:class> 

<m: expiration>o. . i </m: expiration> 

<m:position>i..i</m:position> 

<m:argotQuery>a.i</m:argotQuery> 

<m:argot argotURI="...">o..unbomded {any}<lm\i^xgoX> 
</m:stream> 

<m:coiiiiection changeNumber= ". . id=",.." creator-'... ''>o..unbounded 

<m:class>i..i</m:class> 

<m: status>i .. i</m: status> 

<m:characteristics>i..i</m:characteristics> 

<m:expiration>i..i</m:expiration> 

<m:argotQuery>i..i</m:argotQuery> 

<m:argot argotURI=="...">o..uiiboimded {any}<lm\2XgoX> 
</m:connection> 

<in:subscriptioii changeNumber =". . id=".,." creator="...''>o..unbounded 
<hs:trigger select="..." mode="..." baseChangeNumber="...">i..i</hs:trigger> 

<hs :expires At>o.. i</hs lexpires At> 
<hs:context uri="...">i..i /a/rK/</hs:context> 
<hs:to>i..i</hs:to> 
</m:subscriptioii> 

</m:myAlerts> 
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The myAlerts content document comprises the user content document for alert routing. 
It contains streams, connections, and preferences (general provisioning). The document does 
not contain a list of alerts, as alerts are transitory. NotifyRequest, route, and PollRequest are 
used to send and receive alerts, as described below. 

The /myAlerts/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myAlerts/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a particular service is provisioned for a user. 

The /myAlerts/stream (minOccurs=l maxOccxirs=unbounded) is directed to a stream, 
which comprises an internal object that processes alerts before they are routed to connections. 
Streams can buffer or reroute. The /myAlerts/stream/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. The 
/myAlerts/stream/@id (minOccxjrs=l maxOccurs=l) attribute is a globally unique ID assigned 
to this element by .NET My Services. Normally, .NET My Services generates and assigns this 
ID during an insertRequest operation or possibly during a replaceRequest. Application 
software can override this ID generation by specifying the useClientlds attribute in the request 
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message. After an ID has been assigned, the attribute is read only and attempts to write it are 
silently ignored. 

The /myAlerts/stream/@creator (minOcciirs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. The /myAlerts/stream/class 
(string minOccurs=l maxOccurs=l) defines what kind of stream this is. The 
/myAlerts/stream/expiration (dateType minOccurs=0 maxOccurs=l) specifies the lifetime of a 
connection in absolute time (GMT). This can be used to clean up the content document. The 
/myAlerts/stream/position (string minOccurs=l maxOccurs=l) defines where the stream fits 
into the streamFork processing. 

The /myAlerts/stream/argotQuery (string minOccurs=0 maxOccurs=l) field maintains 
the stream's query against incoming alerts. The query specifies the argot name(s) that enable 
selection (a logical OR of the named argots). This is optional based on the streamClass (e.g., 
a stream may do its own selection processing instead of or in addition to the standard stream 
alert query). If not present, the query defaults to all alert argots ("*"). 

The /myAlerts/stream/argot (minOccurs=0 maxOccurs=unboimded) field comprises an 
optional provisioning argot for the stream, and is dependent on the stream class. The 
/myAlerts/streani/argot/@argotURI (anyURI minOccurs=l maxOccurs=l) URI uniquely 
identifies the type of argot and points to a location containing the XSD for this argot. The 
/myAlerts/stream/argot/ {any} (minOccurs=0 maxOccurs=unbounded) field contains argot 
data. 

The /myAlerts/connection (minOccurs=0 maxOccurs=unbounded) uses the following 
abbreviations: CXN ( for a connection, which exists inside of the .NET Alerts service as 
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described above with reference to FIG. 7), and UA (for a UserAgent, which exists outside of 
the .NET Alerts service). There are two primary types of connections, namely push, wherein 
alerts are pushed by CXN to UA, and pull, wherein alerts are downloaded by the UA by 
issuing a request to CXN. The response contains the alerts. A CXN is created (added to the 
5 .NET Alerts content document) either by the UA directly or by some entity acting on behalf of 
the UA. In order to transfer the alerts, a session, either persistent or transient, is established 
between CXN and UA. In cases in which sessions are transient, the CXN persists. 
EstabHshment of a session can be initiated by a CXN or the UA, when the CXN is created or 
1^^,^ based on, for example, a timer or some signaUng mechanism between CXN and UA. The 
Q 10 session can be closed by either entity after a period of time (including 0). The following are 
'2 different models of UA-CXN interaction: 1) UA establishes a session with a CXN and pulls 
alerts from CXN; 2) UA estabUshes a session with a CXN and the CXN pushes alerts to the 

if 

1,:^, UA; 3) CXN estabUshes a session with a UA and the UA pulls alerts; 4) CXN establishes a 

u 

i y session with a UA and pushes alerts to UA; 5) UA polls the CXN periodically on a timer and 
1'^^^ 15 UA will initiate process 1) or 2); and 6) CXN polls the UA when alerts arrive or periodically 

Mir 

on a timer. When there are pending alerts in the queue, UA will initiate process 1) or 2). 

The /myAlerts/connection/@changeNumber (minOccurs=l maxOccurs==l) 
changeNumber attribute is designed to facihtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
20 read only to applications. Attempts to write this attribute are silently ignored. 

The /myAlerts/connection/@id (minOccurs=l maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services 
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generates and assigns this JD during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this JD generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myAlerts/connection/@creator (minOccurs=l maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformld of the node. The 
/myAlerts/connection/class (string minOccurs=l maxOccurs=l) element specifies the class of 
a connection (for example, Push over Soap-RP or Pull over Soap-RP). 

The /myAlerts/connection/status (string minOccurs=l maxOccurs=l) contains flags 
indicating the current status of the connection. This can be used by the Stream modules to do 
traffic management, buffering, generate non-delivery and delayed delivery reports for the 
sender. The /myAlerts/connection/characteristics (string minOccurs=l maxOccurs=l) field 
contains information about the nature of the connection, used mainly by the Stream modules. 
ReUable can mean it supports ACKs, while unreUable means it is fire-and-forget. 
Characteristics may include the type of poUing used (Connection vs. User Agent). 

The /myAlerts/connection/expiration (dateType minOccurs=l maxOccurs=l) field 
contains the Ufetime of a connection in absolute time (GMT). This can be used to clean up the 
content document. The /myAlerts/connection/argotQuery (string minOccurs=l 
maxOccurs=l) field maintains the connection's query against incoming alerts. The query 
specifies the argot name(s) that enable selection (a logical OR of the named argots). 

The /myAlerts/connection/argot (minOccurs=0 maxOccurs==unbounded) contains an 
optional provisioning argot for the connection. This is dependent on the connection class. The 
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/myAlerts/connection/argot/@argotURI (anyURI inmOccurs=l maxOccurs=l) URI uniquely 
identifies the type of argot and points to a location containing the XSD for this argot. The 
/myAlerts/connection/argot/{any} (minOccurs=0 maxOccurs=unbounded) contains the argot 
data. 

mvAlerts - Domain-Specific Methods 

The myAlerts service uses the standard methods, and domain-specific methods notify 
and poll. The notify method allows a client to send an alert to the userAgents connected for 
the user. The poll method allows a userAgent to proactively pull an alert through a 
connection. 

The myAlerts/notify Method sends one or more alerts to the receiver. If the receiver is 
the .NET Alerts sCTvice, the alert(s) will be dehvered to the appropriate set of connected 
userAgents. The myAlerts/notifyRequest method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following sample 
document Augments illustrate the structure and meaning of the elements and attributes in the 
request and response messages. 

The following table and accompanying description thereafter describes the request 

message for this method: 

<m:notifyRequest 

xmlns:m="http://schemas.microsoft.com/hs/2001/10/myAlerts" 

xmlns:hs="http://schemas.rmcrosoft.coni/hs/2001/10/core">,,.i 
<m:notification id="...">o. mboimdcd 
<m:from>i i 

<m:identityHeadertype="...">o i 
<m:onBehalfOfUser>,..i</m:onBehalfOfUser> 
<m:licenseHolder>i.i</m:licenseHolder> 
<m:platformId>i . i</m:platformId> 
</m:identityHeader> . 
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<Tn:expiresAt ttl="..." onDate="..." replace="...">o, i</m:expiresAt> 

<m:acknowledge>o .i</m:acknowledge> 

<m:category id="...">o„i</m:category> 
</m:from> 
<m:to>o 1 

<m:originalUser>o i</m:originalUser> 
</m:to> 

<m:contents>L i /a/iy^</m:contents> 
<m:routing>i. i 

<m:timestamp>o j</m:timestamp> 

<m:hops>o,. i</m:hops> 
</m:routing> 
</in:notification> 

</m:notifyRequest> ... 

The /notifyRequest (minOccurs=l maxOccurs=l) method attempts to send the 
enclosed alerts using standard routing by ,NET Alerts. There can be one or more notification 
elements specified. If none is specified, the notify request should be interpreted as a query 
about whether the receiver is willing to accept alerts from this sender. The 
/notifyRequest/notification (minOccurs=0 maxOccurs^unbounded) specifies an alert to be 
delivered. The /notifyRequest/notification/@id (string minOccurs=0 maxOccurs=l) and 
/notifyRequest/notification/from (minOccurs=l maxOccurs=l) tag contains all data from the 
sender, including sender authentication as well as preferences and requests from the sender. 

The /notifyRequest/from/identityHeader (minOccurs=0 maxOccurs=l) includes 
/notifyRequest/from/identityHeader/@type (string minOccurs=0 maxOccurs=l) and 
ZnotifyRequest/from/identityHeader/onBehalfOfUser (minOccurs=l maxOccurs=l). The 
uuidType is used to specify a universally unique identifier (UUID). The 
/notifyRequest/from/identityHeader/licenseHolder (minOccurs=l maxOccurs=l) uuidType is 
used to specify a universally unique identifier (UUID). 
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The /notifyRequest/from/identityHeader/platformId (minOcciirs=l maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUID). The 
/notifyRequest/from/expiresAt (string minOccurs=0 maxOccurs=l) is directed to expiration 
time of an alert, including /notifyRequest/from/expiresAt/@ttl (string minOccurs=0 
maxOccurs=l), /notifyRequest/from/expiresAt/@onDate (string minOccurs=0 maxOccurs^l) 
and /notifyRequest/from/expiresAt/@replace (string minOccurs=0 maxOccurs=l). 

The /notifyRequest/from/acknowledge (string minOccurs=0 maxOccurs=l) field 
contains information related to acknowledging the alert, while /notifyRequest/from/category 
(minOccurs=0 maxOccurs=l) and /notifyRequest/fi:om/category/@id (string minOccurs=0 
maxOccurs=l) contains category information. 

The /notifyRequest/to (minOccurs=0 maxOccurs=l) tag contains the data pertaining to 
the receiver. This data can be set by the sender or by any processing/routing agent between 
the sender and the receiver. The /notifyRequest/to/originalUser (minOccurs=0 maxOccurs=l) 
element defines the original receiver of the alert. A routing agent may change (forward or fan 
out) an alert to other receivers. If so, it should add this element to the alert. 

The /notifyRequest/contents (minOccurs=l maxOccurs=l) element contains the 
problem domain-specific data to be conveyed to the receiver. Each child element of the 
contents element is an argot, a problem domain-specific strongly-typed XML blob. Streams 
and connections query against the element names of these blobs when selecting alerts they 
will process. The /notifyRequest/contents/ {any} (minOccurs==0 maxOccurs=ambounded) 
contains the argot data. 
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The /notifyRequest/routing (minOccurs=l maxOccurs=l) tag contains any routing data 
inserted by the myAlerts routhig process. The /notifyRequest/routing/timestamp (string 
minOccurs=0 maxOccurs=l) element contains the timestamp of when the alert was received 
by the myAlerts service. The /notifyRequest/routing/hops (string minOccurs=0 
maxOccurs=l) element defines the actors that have processed the alert to date. This data can 
be used by the myAlerts service to recognize and stop infinite loops. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "simustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

The myAlerts/poU Method poll method can be used on a connection in .NET Alerts to 
retrieve alerts that satisfy the xpQuery specified for the connection. Succeeding poll methods 
on a connection will retum alerts in a first-in (received), first-out (delivered) order for that 
connection. Alerts will be buffered (that is, stored m the .NET Alerts service after receipt and 
later deUvered by a poll method invocation) only if a suitable buffering stream has been 
configured. 

The myAlerts/pollRequest method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following table and 
accompanying description thereafter describes the request message for this method: 
mipollRequest 

xmlns:m=="http://schemas.microsoft.coni/hs/2001/10/myAlerts" 
xmlns:hs="http://schemas.microsoft.coin/hs/2001/10/core">j„i 
<m:parkInterval>o,. i</m:parklnterval> 
</m:pollRequest> 
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The /poURequest (minOcciirs=l maxOccurs=l) method can be invoked on a 
connection. If there is a new alert in the buffer stream, it will be returned in the poUResponse 
message. The pollRequest will immediately retum a response about whether there is a 
pending alert. However, if the optional parklnterval element is specified, then the response 
can take up to parklnterval miUiseconds before returning when there are no new alerts in the 
buffer stream. The /poURequest/parklnterval (string minOccurs=0 maxOccurs=l) field 
specifies the time, wherein the unit of time for parkLiterval is miUiseconds. 

Upon successful completion of this method, a response message, 
myAlerts/pollResponse, is generated. The format of the response message is described below, 
wherein the number of alerts retumed in the response can be zero or one: 



<m:pollResponse 

xmlns:m="http://schemas.microsoft.coni/hs/2001/10/myAIerts" 
xmlns:hs="http://schemas,microsoft.coni/hs/2001/10/core">i,j 
<m:notification id- '...">a i 
<m:from>L.i 
<m:identityHeader type="...">o a 

<m:onBehalfOfUser>K.i</m:onBehaifOfUser> 
<m:licenseHolder>K.i</m:licenseHolder> 
<m:platformId>i .i</m:platformId> 
</m:identityHeader> 

<m:expiresAt ttl="..." onDate="..." replace="...">o.j</m:expiresAt> 

<m:acknowledge>o.. i <ym:acknowledge> 

<m:category id="...">o i</m:category> 
</m:from> 
<m:to>o.j 

<m:originalUser>o.. i</m:originalUser> 

</m:to> 

<m:contents>i„i /a/ij;y</m:contents> 
<m:routing>i. i 

<m:timestamp>o, j</m:timestamp> 

<m:hops>(} . 1 </m:hops> 
</m:routing> 
</m:notification> 

<;/m:pollResponse> 
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The /poUResponse (minOccurs=l inaxOccurs=l) response contains zero or one new 
alerts in the buffer stream. The /pollResponse/notification (minOccurs=0 maxOcciirs=l) 
comprises a new alert contained in the buffer stream. The /pollResponse/notification/@id 
(string minOccurs=0 maxOccurs=l) contains an identifier 

The /pollResponse/notification/from (minOccurs=l maxOccurs=l) tag contains data 
from the sender, including sender authentication as well as preferences and requests from the 
sender. The /pollResponse/from/identityHeader (minOccurs=0 maxOccurs=l) includes 
/pollResponse/from/identityHeader/@type (string minOccurs=0 maxOccurs=l) and 
/pollResponse/from/identityHeader/onBehalfOfUser (minOccurs=l maxOccurs=l). The 
uuidType is used to specify a universally unique identifier (UUID). The 
/pollResponse/from/identityHeader/licenseHolder (minOccurs=l maxOccurs=l) uuidType is 
used to specify a universally unique identifier (UUID). 

The /pollResponse/from/identityHeader/platformId (minOccurs=l maxOccurs=l) 
uuidType is used to specify a imiversally unique identifier (UUID). The 
/poUResponse/from/expiresAt (string minOccurs=0 maxOccurs=l) is directed to expiration 
time of an alert, including /pollResponse/from/expiresAt/@ttl (string minOccurs=0 
maxOccurs=l), /pollResponse/from/expiresAt/@onDate (string minOccurs=0 maxOccurs=l) 
and /pollResponse/from/expiresAt/@replace (string minOccurs=0 maxOccurs=l). 

The /polIResponse/from/acknowledge (string minOccurs=0 maxOccurs=l) field 
contains information related to acknowledging the alert, while /poUResponse/from/category 
(minOccurs=0 maxOccurs=l) and /pollResponse/from/category/@id (string minOccurs=0 
maxOccurs=l) contains category information. 
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The /pollResponse/to (imnOccurs=0 maxOccxirs^l) tag contains the data pertaining to 
the receiver. This data can be set by the sender or by any processing/routing agent between 
the sender and the receiver. The /pollResponse/to/originalUser (minOccurs=0 maxOccurs=l) 
element defines the original receiver of tibe alert. A routing agent may change (forward or fan 
5 out) an alert to other receivers. If so, it should add this element to the alert. 

The /pollResponse/contents (minOccurs=l maxOccurs=l) element contains the 
problem domain-specific data to be conveyed to the receiver. Each child element of the 
contents element is an argot, a problem domain-specific strongly-typed XML blob. Streams 

I, A and connections query against the element names of these blobs when selecting alerts they 

□ 

□ 1 0 will process. The /pollResponse/contents/{any} (minOccurs=0 maxOccurs=unbounded) 

I contains the argot data. 

The /pollResponse/routing (mmOccurs=l maxOccurs=l) tag contains any routing data 

I A inserted by the myAlerts routing process. The /pollResponse/routing/tunestamp (string 

S U minOccurs=0 maxOccurs=l) element contains the timestamp of when the alert was received 

i' it s 
f "«? 

p 15 by the myAlerts service. The /pollResponse/routing/hops (string minOccurs=0 maxOccurs=l) 
element defines the actors that have processed the alert to date. This data can be used by the 
myAlerts service to recognize and stop infinite loops. 

The myAlerts/humanReadable Notification Argot (the humanReadable argot) defines 
the standard XML schema to convey alert data that should be displayed to human beings to 
20 the userAgents: 



<m:humaiiReadable 

xmlns:m="http://schemas,microsoftxom/hs/2001/10/myAlerts'' 
xmbis:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:baseUrl>i..i</m:baseUrl> ^ 
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<m:actionUrl>i„i</m:actionUrl> 
<m:subscriptionUrl>i.,i</m:subscriptionUrl> 
<m:language xml:lang="../' iconUrl="...">i..^bounded 

<m:text>i..i</m:text> 
</m:language> 

</m:humanReadable> 

The /humanReadable (minOccurs=l maxOccurs=l) element is an argot used to convey 
human readable information in an alert. The receiver of a human readable alert should be able, 
at a minimum, to display the text element data to a human in either textual or speech form. 
The /humanReadable/baseUrl (anyURI minOccurs=l maxOccurs=l) comprises a base URL to 
which all other URLs are relative. 

The /humanReadable/actionUrl (anyURI minOccurs=l maxOccurs=l) comprises a 
URL that links to an action page from the sender. This URL can be relative to the baseURL 
element. The /humanReadable/subscriptionUrl (anyURI minOccurs-1 maxOccurs=l) 
comprises a URL tiiat links to the sender's page to allow the receiver to view and change the 
way the alert was sent. This URL can be relative to the baseURL element. 

The /humanReadable/language (minOccurs=l maxOccurs=unbounded) element 
contains text specific to a language. As many language elements as desired can be included to 
convey the same information in different languages. The 

/humanReadable/language/@xml:lang (minOccurs-1 maxOccurs=l) required attribute is used 
to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 1766. 
The value of this attribute indicates the language type of the content within this element. The 
/humanReadable/language/@iconUri (anyURI minOccurs=0 maxOccurs=l) attribute contains 
an optional URL from the sender for an icon in a Portable Network Graphics (PNG) file that 
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can be used when the userAgent displays the content to the user. The 
/humanReadable/language/text (string minOccurs==l maxOccurs=l) element contains the text 
to be conveyed to the human. This text is in the language specified by the xmlilang attribute. 
The myAlerts/bufferStreamParameters provisioning argot (the bufferStreamParameters 
5 argot) defines the data returned by a query from a streamBuffer: 



<m:bufferStreamParameters 
xnilns:m="http://schemas.microsoft.coni/hs/200 1/1 0/myAlerts" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i„i 

<m:notification id- '...">o..unbounded 
<m:from>i..i 
<m:identityHeader type="...">o..i 
<m:onBehalfOfUser>i..i</m:onBehalfOfUser> 
<m:licenseHolder>i„i</m:licenseHolder> 
<m:platformId>i..i</m:platforniId> 
</m:identityHeader> 

<m:expiresAt ttl="..." onDate="..." replace="...">o.,i</m:expiresAt> 

<m:acknowledge>o..i</ni:acknowledge> 

<m:category id="...">o„i</m:category> 
</m:from> 
<m:to>o..i 

<m:originalUser>o..i</m:originalUser> 

</m:to> 

<m:contents>i„i /a/fy/</m:contents> 
<m:routing>i.j 

<m:timestamp>o..i</m:timestainp> 
<m:hops>o..i</m:hops> 
</m:routing> 
</m:notification> 
</m:bufferStreamParameters> 



The /bufferStreamParameters (minOccurs=l maxOccurs=l) element comprises an 
argot specifying the read and write parameters for a bufferStream stream. For one current 
implementation of .NET My Services, the bufferStream takes no input parameters; it retums 
10 the current set of buffered alerts through this argot. A query on a bufferStream is a transient, 
read-only operation. The /bufferStreamParameters/notification (minOccurs=0 
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maxOccurs=unbounded) is directed to zero or more alerts in the buffer of the streamBuffer 
stream. 

The /bufferStreamParameters/notification (minOccurs=0 maxOcciirs=l) comprises a 
new alert contained in the buffer stream. The /bufferStreamParameters/notification/@id 
(string minOccurs=0 maxOccurs==l) contains an identifier 

The /bufferStreamParameters/notification/from (minOccurs==l maxOcc\irs=l) tag 
contains data from the sender, including sender authentication as well as preferences and 
requests from the sender. The /bufferStreamParameters/from/identityHeader (minOccurs=0 
maxOccurs=l) includes ^ufferStreamParameters/from/identityHeader/@type (string 
minOccurs=0 maxOccurs=l) and 

^ufferStreamParameters/from/identityHeader/onBehalfOfUser (minOccurs=l maxOccurs=l). 
The uuidType is used to specify a universally unique identifier (UUID). The 
^ufferStreanlParameters/from/identityHeader/licenseHolder (minOccurs=l maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUID). 

The ^ufferStreanlParameters/fi•om/identityHeader/platfo^nId (minOccurs=l 
maxOccurs=l) uuidType is used to specify a universally unique identifier (UUID). The 
/bufferStreamParameters/from/expiresAt (string minOccurs=0 maxOccurs=l) is directed to 
exph-ation time of an alert, including /bufferStreamParameters/fi'oni/expiresAt/@ttl (string 
minOccurs=0 maxOccurs=l), /bufferStreamParameters/fi:om/expiresAt/@onDate (string 
minOccurs=0 maxOccurs=l) and ^ufferStreamParameters/from/expiresAt/@replace (string 
minOccurs=0 maxOccurs=l). 
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The /bufferStreamParameters/from/acknowledge (string minOcciirs=0 maxOccurs=l) 
field contains information related to acknowledging the alert, while 
^ufferStrea^lParameters/from/category (minOccurs=0 maxOccurs=l) and 
/bufferStreamParameters/froni/category/@id (string minOccurs=0 maxOccurs=l) contains 
category information. 

The /bufferStreamParameters/to (minOcciirs=0 maxOccurs=l) tag contains the data 
pertaining to the receiver. This data can be set by the sender or by any processing/routing 
agent between the sender and the receiver. The /bufferStreamParameters/to/originalUser 
(minOccurs=0 maxOccurs=l) element defines the original receiver of the alert. A routing 
agent may change (forward or fan out) an alert to other receivers. If so, it should add this 
element to the alert. 

The /bufferStreamParameters/contents (minOccurs=l maxOccurs=l) element contains 
the problem domain-specific data to be conveyed to tiie receiver. Each child element of the 
contents element is an argot, a problem domain-specific strongly-typed XML blob. Streams 
and connections query against the element names of these blobs when selecting alerts they 
will process. The /buflferStreamParameters/contents/{any} (minOccurs=0 
maxOccurs=unbounded) contains the argot data. 

The /bufiferStreamParameters/routing (minOccurs=l maxOccurs=l) tag contains any 
routing data inserted by the myAlerts routing process. The 

/bufferStreamParameters/routing/timestamp (string minOccurs=0 maxOccurs=l) element 
contains the timestamp of when the alert was received by the myAlerts service. The 
/bufferStreamParameters/routing/hops (string minOccurs=0 maxOccurs=l) element defines 
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the actors that have processed the alert to date. This data can be used by the myAlerts service 
to recognize and stop infinite loops. 

The myAlerts/pushConnectionParameters Provisioning Argot 
(pushConnectionParameters argot) defines the data passed to and returned from 
connectionPush: 



<m:pushConnectionParameters 

xmlns:m="http://schemas.microsoft.com/hs/2001/10/myAlerts'' 

xmlns:hs="http://schemas.microsoft.coiii/hs/2001/10/core''>i i 

<m:targetUrl>i..i</in:targetUrl> 
</m:pushComiectionParameters> 

The /pushConnectionParameters (minOccurs=l maxOccurs=l) element comprises an 
argot specifying the read and write parameters for a connectionPush connection. The 
/pushConnectionParameters/targetUrl (string minOccurs=l maxOccurs=l) contains a target 
URL; the push connection will issue notifyRequest packets to this target URL. 

mvApplicationSettinss 

The myAppUcationSettings service 302 is designed to store application settings for 
applications and for groups of applications. The service is structured around the 
appUcationSetting element. This element is a .NET My Services blue item, as described 
above, meaning that it may be cached and replicated using standard .NET My Services 
caching and replication techniques. This element is designed to store and manage a 
categorized set of named application settings. Categorization is done using standard .NET My 
Services categorization. The applicationSettings are named using the name element which is 
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a URI. An applicationSetting may have multiple names meaning that the setting is used by a 
number of applications. The settings themselves are represented using free-form, namespace 
qualified XML. For example, a setting might look something like in the following table: 



<m:applicationSetting 

xmhis:m=*littp://schemas.microsoft.com/hs/2001/10/myApplicationSettings" 

> 

<m:name>http://schemas.microsoftxom/hs/2001/10/sdkSamples/xslcal</m:nam^ 

<!-- 

// 

// xcal settings 
// 

-> 

<xcal:settings 

xmlns:xcal="http://schemas.microsoftxomyhs/2001/10/sdkSamples/xslcar 

> 

<xcal:initialPmd>6108</xcal:initialPuid> 
<xcal:defaultView>weekView</xcal:defaultView> 
</xcal:settings> 

</m:applicationSetting> „ 

It is expected that applications will use names in either the uuid: URI scheme, or a 
hierarchical and distributed management scheme hke http:. 



mvApplicationSettims/ Roles 

The myApplicationSettings service controls access by using the roleTemplates, rtO, 
rtl, rt2, rt3, and rt99, using the following scopes: 



scope allEIements 

<hs:scopeid=7215df55-e4af-449f-a8e4-72alf7c6a987> 

<hs:sh^e base=t> 

</hs:shape> 
</hs:scope> 
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scope onlySeUElements 

<hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 

<hs:includeselect=//*[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scopeid=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base=nil> 

<hs:include select=//subscription[@creator=* $callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8£> 
<hs:shape base=iiil> 
<hs:include select-//*[cat/@ref^*hs:public']/> 
<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

The myApplicationSettings roleTemplate rtO role gives give complete read/write 
access to the information within the content document of the service being protected through 
this roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myApplicationSettings service through that method while mapped to this 
roleTemplate. 



T ABLE -myApplica tionSettings roleTemplate rtO 



method 


scope/name 


query 


allElements j 


insert 


allElements 


replace 


allElements 


delete 


allElements j 


update 


allElements \ 
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The myApplicationSettings roleTemplate rtl role gives complete read access to all 
information within the content docxmient of the service being protected through this 
roleTemplate. Applications mapping to this role also have a Umited ability to write to 
information in the content document. Applications may create nodes in any location, but may 
only change/replace, or delete nodes that they created. The following table illustrates the 
available methods and the scope in effect when accessing the myApplicationSettings service 
through that method while mapped to this roleTemplate: 



1 method 


scope/name | 


[Query 


allElements j 


|hisert 


onlySelfElements 


IReplace 


onlyS elfElements \ 


[Delete 


onlySelfElementSj 



The myAppUcationSettings roleTemplate rt2 gives complete read access to all 
information within the content document of the service being protected through this 
roleTemplate. Apphcations mapping to this role have very limited write access and are only 
able to create and manipulate their own subscription nodes. The following table illustrates the 
available methods and the scope in effect when accessing the myApplicationSettings service 
through that method while mapped to this roleTemplate. 



method 


scope/name 


query 


allElements 


insert 


onlySelfSubscriptionElementS: 


replace 


onlySelfSubscriptionElements! 


delete 


onlySelfSubscriptionElements! 
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The myApplicationSettings roleTemplate rt3 gives limited read access to information 
within the content document that is categorized as "pubUc." The following table illustrates 
the available methods and the scope in effect when accessing the myApphcationSettings 
service through that method while mapped to this roleTemplate: 
TABLE - myApplicationSettmgs roleTemplate rt3 



The myApplicationSettings roleTemplate rt99 blocks access to the content 
document. Note that lack of a role in the roleList has tiie same effect as assigning someone to 
rt99. The following table illustrates that there are no available methods and the scope in effect 
when accessing the myApplicationSettings service through that method while mapped to this 
roleTemplate (note that in other services described herein, such an empty table will not be 
repeated): 

TABLE - myApplica tionSettings roleTemplate rt99 
|method|[scope/name, 

mvApplicationSettinss / Content 

The content document is an identity centric documrait, with its content and meaning 
being a fimction of the puid used to address the service. Accessing the content document is 
controlled by the associated roleList document. This schema outline in the following table 
illustrates the layout and meaning of the information found in the content document for the 
myApplicationSettings service: 
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<m:myApplicatioiiSettmgs changeNttmber= '\>/' instanceld-'..." 
xmlns:m="http://schemas,microsoftxom/hs/2001/10/myApplication 
xmlns:hs="http://schemas.microsoftxom/hs/2001/10/co^^^ 
<m:applicationSettiiig changeNumber= "...'' id="..." creator",.. ">o..unbounded 

<m:cat rrf='\./'>o..unbounded</micat> 

<m:name> o „^hniindi.H< /m:name> 

{any} 

<;/m:applicationSettmg> 

<m:subscriptioii changeNumbei^ ''../' id-',.." creator=="...">o unbounded 

<hs:trigger select="..." mode='\,r baseChangeNumber="...">i..i</hs:trigger> 

<hs:expiresAt>o„i</hs:expiresAt> 

<hs:context uri="...">i..i /awj;;</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscriptioii> 
{any} 

</m:myAppIicatioiiSettings> ^ 

The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myApplicationSettings (minOccurs=l maxOccurs=l) element encapsulates the 
content document for the service. The service is designed to store and manage application 
settings that are described via well formed, namespace quahfied XML. The 
/myAppUcationSettings/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored, e.g., without an error being 
generated. 
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The /myApplicationSettings/@instanceId (string niinOccurs=0 maxOccurs=l) 
attribute is a unique identifier typically assigned to the root element of a service. It is a read- 
only element and assigned by the .NET My Services system when a user is provisioned for a 
particular service. The /myApplicationSettings/applicationSetting (minOccurs=0 
maxC)ccurs=unbounded) element defines the basic unit of storage within this service which is 
the apphcationSetting. An applicationSetting is cacheable and replicable through normal 
.NET My Services caching and replication techniques. An applicationSetting is identified by 
a single and stable id (the @id) attribute. An applicationSetting may also be known by a 
number of applicationSettingNames which are defined as URIs. The substance part of an 
application setting is represented by an {any} entry, which essentially is a shorthand notation 
for any, fi-ee-form, namespace qualified XML. 

The /myApplicationSettings/applicationSetting/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The myApplicationSettings/applicationSetting/@id (minOccurs=0 maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services will generate and assign this ID during an insertRequest operation, or 
possibly during a replaceRequest. AppUcation software can override this ID generation by 
specifying the useChentlds attribute in the request message. Once an ID is assigned, the 
attribute is read-only and attempts to write it are silently ignored. The 
/myAppUcationSettings/appUcationSetting/@creator (string mmOccurs=0 maxOccurs=l) 
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attribute identifies the creator in terms of userld, appid, and platformid of the node. 

The /myApplicationSettings/applicationSetting/cat (minOccurs=0 
maxOcciirs=unbounded) element is used to categorize the element that contains it by 
referencing a global category definition in either the .NET Categories service system 

5 document or an external resource containing category definitions, or by referencing an identity 
centric category definition in the content document of the .NET Categories service for a 
particular puid. The /myApplicationSettings/appUcationSetting/cat/@ref (anyllRI 
minOccurs=0 maxOccurs=l) attribute references a category defmition (<catDef >) element 
using the rules outlined in the myCategories section of the present application, described 

10 below. 

The /myApplicationSettings/applicationSetting/name (anyURI minOccurs=0 
maxOccurs=unbounded) element defines a unique name for the ^pHcationSettmg that 
programmers will code to. It is a stable name defined by the applications vs. the @id 
attribute which is a stable and unique name defined by .NET My Services. The format of this 
1 5 name is a URI. It is expected that apphcations will name their applicationSettings using URIs 
with the uuid: scheme, or an http: scheme which allows a delegated hierarchical namespace, 
e.g., 

Uuid:56c3da65-a6d6-4f78-bbbd-e8c5eac98aae. The 
http://schemas.microsoft.eom/office/2002/08/outlook#coolTools 
20 http://schemas.microsoft.eom/vs/2002/03/studio#codeLayout element may be repeated any 
number of times to indicate that this applicationSetting is used by a number of applications. 
The /myAppUcationSettings/applicationSetting/{any} (minOccurs=0 
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maxOccurs=unbounded) field allows the schema to be extended to specify other types of 
application setting-related data. 

The subscription elements and attributes are common to other services, and are 

described above. 

5 

mvCalendar 

The .NET Calendar service, alternatively referred to herein as myCalendar 303, 
provides calendars for users. This particular service uses an XML schema to describe a typical 
i X calendar, a user's calendar store, and the methods by which calendar data is sent and received 
;;310 firom the store. 

''4 The .NET Calendar service stores and manages the scheduling of individual and group 

3 events and appomtments that are associated with an identity. This service supplies scheduUng 
U information on demand to other .NET My Services, appUcations, and devices. .NET Calendar 
fO can be used for regular scheduling or group collaboration. Group collaborative features 
Q 1 5 include meeting delegates and role-based access to another identity's calendar. 

The .NET Calendar service is designed to work with the .NET Alerts service to 
perform reminder alerts and meeting acceptance/decline alerts, with .NET Contacts for service 
distribution lists, and with .NET Inbox to send and retrieve meeting requests. .NET Inbox will 
forward meeting invitations to be direct booked (tentative) on attendee calendars which have 
20 the correct permissions for this behavior and will forward meeting responses that attendees 
send back to the organizer to update the organizer's calendar. 
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.NET Calendar will support calendar publishing. This feature that allows users to 
open their calendars to other users such as friends, family members, and group lists. The .NET 
Calendar service uses .NET My Services to support a rich sharing model based upon the 
access control list, role map, and identity header. 
5 The .NET Calendar schema format improves established existing calendar properties 

and standards, hi addition, .NET Calendar estabUshes a platform for non-Gregorian calendars 
and additional features such as traveling time allowances for meetings. The schema is 
designed to be extensible to accommodate new calendar properties or additional recurrence 

j,^ patterns. 

□ 10 

*' - s 

% mvCalendar /Roles 

[ ^ The myCalendar service controls access by using the rtO, rtl , rt2, rt3 and rt99 

\ U roleTemplates, using the following scopes: 

Q 15 scope allElements 

<hs;scope id=721 5df55-e4af-449f-a8e4-72ainc6a987> 

<hs: shape base=t> 
</hs:shape> 
</hs:scope> 

20 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 
<hs:includeselect=//*[@creator='$callerId']/> 

25 </hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 
30 <hs:shape base=nil> 
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<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

5 scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8£> 
<hs:shape base=nil> 
<hs:includeselect=//*[cat/@ref=*hs:public']/> 
<hs:include select=//subscription[@creator='$callerId']/> 
10 </hs:shape> 
</hs:scope> 



The myCalendar roleTemplate rtO role gives complete read/write access to the 
^ 1 5 information within the content document of the service being protected through this 
O roleTemplate, The following table ilhistrates the available methods and the scope in effect 
when accessing the myCalendar service through that method while mapped to this 
roleTemplate: 

Ms 

P 20 TABLE - myCalendar roleTemplate rtO 



method 


scope/name 


query 


allElements 


insert 


allElements 


replace 


allElements - 


delete i 


allElements 


update j 


allElements 


getCalendarDays 


allElements 


getFreeBusyDays 


allElements 


getQuickView 


allElements 


sendMeeting 


allElements 


respond 


allElements 


updateReminder 


allElements 
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The myCalendar roleTemplate rtl role gives complete read access to all information 
within the content document of the sendee being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content documeat. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illuslxates the available methods and the 
scope in effect when accessing the myCalendar service through diat metiiod while mapped to 
this roleTemplate: 



TABLE - myCalendar roleTemplate rtl 



method 


scope/name 


query 


allElements 


insert 


onlySelfElements 


replace 


onlySelfElements 


delete 


onlySelfElements 


update 


allElements 


getCalendarDays 


allElements 


getFreeBusyDays 


allElements 


getQuickView 


onlySelfElements 


sendMeeting 


onlySelfElements 


respond 


onlySelfElements 



The myCalendar roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myCalendar service through that method 
while mapped to this roleTemplate: 
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TABLE - myCalendar roleTempiate rt2 



method 


scope/name 


uLiwi y 


allRlements 


insert 


onlySelfSubscriptionElements 


replace 


onlySelfSubscriptionElements ! 


delete 


onlySelfSubscriptionElements 


getCalendarDays 


allElements 


getFreeBusyDays 


allElements 


getQuickView 


allElements 



The myCalendar roleTempiate rt3 role gives limited read access to information within 
the content document that is categorized as "public." The following table illustrates the 
available methods and the scope in effect when accessing the myCalendar service through that 
method while mapped to this roleTempiate: 



TABLE - myCalendar roleTempiate rt3 



method 


scope/name 


query 


onlyPublicElements 


getCalendarDays 


onlyPublicElements 


getFreeBusyDays 


onlyPublicElements 


getQuickView 


onlyPubhcElements 



The myCalendar roleTempiate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 

myCalendar / Content 

The content docimient is an identity centeic document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
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outline that illustrates the layout and meaning of the information found in the content 
document for the myCalendar service: 



<m:myCalendar changeNumber- instanceld="». " 
xmlns:m="http ://schemas.microsoftxom/hs/200 1 / 1 0/myCalendar" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i.a 
<m:event calendarTvpe ='\„" advanceHijriValue="..." changeNmnber- id- 

CreatOr=="...''>o..mibounded 

<iii:body changeNumber= ".,.">i i 
<m;cat ref="../'>o „nho,mrfP.H< /m;cat > 
< m:title xmhlang-" ..." dir="...">i ,< /m:title> 
<m:fullDescription xnd:lang==".. " dir="...">a.i</m:fullDescription> 
<m:location xml:lang="..." dir="...">o..i</m:location> 
<m:meetingStatus>o..i</m:meetingStatus> 
<m;recurrenceld> n i< /m:recurreiiceld> 
<m:lastUpdateTime>o..i</m:lastUpdateTime> 
<m;startTime> i i< /m:startTime> 
<m;endTime> i i< /m:endTime> 
<m:allDay>o..i</m:allDay> 
<m;floating>o.. i</m:floating> 
<m;travelTimeTo>o..i</m:travelTimeTo> 
<m:travelTimeFrom>o..i</m:travelTimeFrom> 
<m:freeBusyStatus>o..i*^/ni:freeBusyStatus> 
<in;cnid> n f<; /m;cuid > 
<m:organizer>o.i 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

<hs;puid> n i< /hs;puid> 

<hs;email> n i< /hs;email> 
</m:organizer> 
{any} 
</ii[i:body> 

<m:attendeeEventExtra changeNumber =''... ">o i 
<m:intendedFreeBusy>o..i</m:intendedFreeBusy> 
<m:responseTime>o..i</ni:responseTime> 
<m:responseType>o.. i</m:responseType> 
<m:counterProposeStartTime>o.. i </m: counterProposeStartTime> 
<m:counterProposeEndTime>a,i</m:counterProposeEndTime> 
<m:counterProposeLocation>o..i</m:counterProposeLocation> 
<m:responseBody xml:lang="..." dir="...">o,.i</m:responseBody> 
<m:delegateResponder>o..i 

<hs:name xml:lang="..." dir=**...">a.i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:email> 
</m:delegateResponder> 
fany} 

</m:attendeeEventExtra> 
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<m:attachmeiit changeNamber= *' . . . " id="..." creator- '...''>o. unbounded 
<m:name xml:lang="..." dir="...">i..i</m:name> 
<ni:contentType>i ..i</m:contentType> 

<m:contentTransferEncoding>i..i</m:contentTransferEncoding> 
<ni: size> i j </m: size> 

<m:attaclimentBody>i..i</m:attachmenfBody> 
</m:attachineiit> 

<m:reminder changeNmnber^ ''../' id="..." creator= "../'>n i 
<m:set>i..i</m:set> 

<m:to xinl:lang="..." dir="...">i..i</m:to> 
<m:offset>i..i</m:offset> 
<m:intermptabili1y>o..i</m:interruptability> 
<m:lastSentTime>i..i</m:lastSentTime> 
<m;nextTriggerTime> i i< /m;aextTriggerTime> 
</in:reininder> 

<m:attendee changeNumber- * . . " id- creator="...">o..unbounded 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

< hs;pmd >n i< /hs:puid> 

<hs:eiiiail> n t< /hs;einail> 

<m:inviteType>K.i</m:inviteType> 

<m:responseTime>o..i</in:responseTime> 

<m:responseType>o..i</m:responseType> 

<m:counterProposeStartTime>o..i</m:counterProposeStartTiTne> 

<m:coiinterProposeEndTime>o..i</m:counterProposeEndTime> 

<m:coimterProposeLocation>o..i</in:counterProposeLocation> 

<m:responseBody xml:Iang=",.." dir="...">o..i</m:responseBody> 

fany} 
</m:attendee> 

<m:recurrence changeNumber- '.. ">o i 
<in:rule changeNmnber- \./'>i i 
<m:creationDate>i..i</ni:creationDate> 
<rn:firstDayOfWeek>i,.i</m:firstDayOfWeek> 
<m:tzid>o..i</m:tzid> 
<in:isLeapYear>o..i</m:isLeapYear> 
<m:IeapMonthVaIue>o.,i</m:leapMonthValue> 
<m:repeat>i..i 
<Tn:daily dayFrequency="...">o..i</ni:daily> 

<m:weekly su="..." mo="..." tu="..." we="..." th-"..." fr="..." sa="..." 
weekFrequency="../'>o..i</m:weekly> 

<ni:monthlyByDay su="..." mo="..." tu="..." we="..," th="..;' fr="..." sa="..." 
monthFrequency=*\./'weekdayOfMonth=*\./>o..i</in:m 

<m:monthly monthFrequency="..." day="..." forceExact="...">o..i</ni:monthIy> 

<m:yearlyByDay su=".,/' mo="..." tu=".,." we="..." th="../' fr="..." sa="..." 
yearFrequency="..." weekdayOfMonth="../' month="...">o..i</ni:yearlyByDay> 

<m:yearly yearFrequency="..." month-',. " day="..." 
forceExact="...">o..i</m:yearly> 

{anvl 

</m:repeaP* 
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<m:windowEnd>o..i</m:windowEnd> 
<m:repeatForever>o..i</in:rq)eatForever> 
<m:repeat]hstances>o..i</m:rq)eatInstances> 
<m:deletedExceptiotiDate>o..„nbomded</ni:deletedExceptionDate> 
{any} 
</in:ruIe> 

<iii: exception changeNumber-'...'' id="..." ci2ator=="...''>o .unbounded 
<m:recttrrenceld> t i < /m:recttrr eiiceld> 

<m:body>o.i 
<m:title xml:lang="..," dir="...">o..i</m:title> 
<m:fullDescription xnil:lang="..." dir="..,">o..i</tn:fullDescription> 
<m:location xinl:lang="..." dir="...">o„i</m:location> 
<m:startTime> n i< /m;startTime> 
< in:endTime> n i< /ni:endTlme> 
<m:allDay>o..i</m:allDay> 
<m:travelTimeTo>o..i</ni:travelTimeTo> 
<m:travelTimeFrom>o..i</Tn:travelTimeFrom> 
<m:freeBusyStatus>o..i</^'freeBusyStatus> 
<m:organizer>o,.i 

<hs:name xnil:lang="..." dir="...">o..i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:einail> 
</m:organizer> 
</m:body> 

<m:attendeeEventExtra>o..i 
<m:intendedFreeBusy>o,.i</m:intendedFreeBusy> 
<m:responseTime>o..i</m:responseTime> 
<m;responseType>o..i</m:responseType> 
<m:counterProposeStartTime>o..i</ni:counterProposeStartTime> 
<m:counterProposeEndTime>o..i</ni:counterProposeEndTime> 
<in:counterFroposeLocation>o..i</m:counterProposeLocation> 
<m:responseBody xml:lang="..," dir="...*'>o..i</m:responseBody> 
<m:delegateResponder>o..i 

<hs:name xml:lang="..." dir="...">o..i^s:name> 

<hs:puid>o..i</hs:puid> 

<hs: email>o.. i</hs:email> 
</m: delegateResponder> 
{any} 

</m:attendeeEventExtra> 

<m:deletedAttendee>a.unbounded</in:deletedAttendee> 
<m:deletedAttachment>o..mibounded</ni:deletedAttachinen 

<m: at1:achTnent>o..unbounded 
<m:name xml:lang="..." dir="..,">i..i</m:naine> 
<m:contentType>i..i</m:contentType> 

<m:contentTransferEncoding>i.j</m:contentTransferEncoding> 

<m:size>i..i</m:size> 

<m: attachmentBody> i i </m: attachmentBody> 
</m: attachment> 
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<m:attendee>o ..unbounded 

<hs:name xinl:lang="..." dir="...">o..i</hs:name> 

<hs:puid>o..i</hs:puid> 

<hs:email>a.i</hs:email> 

<m:inviteType>i.j</m:inviteType> 

<m:responseTime>o,.i</m:responseTime> 

<in:responseType>o..i</m:responseType> 

<m:comterProposeStartTime>o..i</m:counterProposeStartTime> 

<m:counterProposeEndTime>o..i</ni:counterProposeEndTime> 

<m:counterProposeLocation>o..i</m:counterProposeLocation> 

<m:responseBody xml:lang="..." dir="...">o..i</m:responseBody> 

{any} 
</m:attendee> 
<m:reminder>o..i 

<m:set>o..i</ni:set> 

<m:offset>o..i</ni:offset> 

<m:intermptability>o..i<m:interruptability> 
</m:reminder> 
fany} 
</m:exception> 
{any} 
</m:recurreiice> 
</in:event> 

<m:sabscriptioii changeNumber= " . . . " id="..." creator-*... ''>o..unbounded 

<hs:trigger select="..." inode="..." baseChangeNumber-"..;'>i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri="...">i..i /a»j?/</hs:context> 

<hs:to>i..i</hs:to> 
</in:subscriptioii> 
{any} 

</m:myCalendar> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myCalendar (minOccurs=l maxOccurs=l) element encapsulates the content 
document for this service. This element establishes a global cache scope for the service and 
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contains other root level system attributes for this instance of the service. The 
/myCalendar/@changeNiimber (nunOcciirs=l maxOccurs=l) changeNumber attribute is 
designed to facilitate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read only to applications. 
Attempts to write this attribute are silently ignored. The /myCalendar/@mstanceId (string 
minOccurs=0 maxOccurs=l) attribute is a unique identifier typically assigned to the root 
element of a service. It is a read-only element and assigned by the .NET My Services system 
when a particular service is provisioned for a user. 

The /myCalendar/event (minOccurs=0 maxOccurs=unbounded) event is the 
myCalendar root object for calendar events, appointments, and meetings. 

The /myCalendar/event/@calendarType (string minOccurs=0 maxOccurs=l) field 



identifies an enumeration which determines the kind of calendar event this is. 



Value 


Enumeration Constant 1 


Description j 


-1 ; 


HSCAL_ALL_CALENDARS | 


Unknown Calendar; system default ^ 
(HSCAL_GREGORIAN_US) 


1 i 


HSCAL GREGORIAN 


Gregorian (localized) calendar 


2 1 


HSCAL GREGORIANJJS ! 


Gregorian (U.S.) calendar J 


3 


HSCALJAPAN 


Japanese Emperor Era calendar J 


4 


HSCAL TAIWAN 


Taiwan Era calendar i 


5 


HSCAL KOREA ' 


Korean Tangun Era calendar j 


6 i 


HSCALjnjRI 


Hijri (Arabic Lunar) calendar j 


■7 


HSCAL THAI 


Thai calendar i 




HSCAL HEBREW 


Hebrew (Limar) calendar j 


9 


HSCAL_GREGORIAN_ME_FRENCH 


Gregorian Middle East French calendar ; 


10 


HSCAL_GREGORIAN_ARABIC 


Gregorian Arabic calendar ; 


11 


" 

HSCAL_GREGORIAN_XLIT_ENGLISH 


Gregorian Transliterated EngUsh 
calendar 1 


|12 


HSCAL_GREGORIAN_XLIT_FRENCH 


Gregorian Transhterated French calendar . 
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1 1. I 
I J ' 


HCPAT TTDUPA TTTMAT? i 


Default Korea Lunar calendar i 


1 A I 


TT^sPAT TAP AN TTJNAR i 


Default Japanese Lunar calendar ] 


15 _J 


HSCAL CHINESE^LUNAR 


Chinese Lunar calendar I 


16 ! 


HSCAL SAKA 


Indian Saka calendar ' 


17 


HSCAL LUNAR_ETO_CHN 


[Chinese Zodiac calendar : 


18 


HSCAL LUNAR ETO KOR 


[Korean Zodiac calendar 


19 


HSCAL LUNAR ROKUYOU 


1 Japanese Lucky days calendar i 



The /myCalendar/event/@advanceHijriValue (int imnOccurs=0 maxOccurs=l) field is 
required for Hijri calendar support. @advanceHijriValue ranges from {-3,-2,-1,1.2,3} and is 
added to the current date, but the day of the week stays the same. For example, if today is the 
24th and @advanceHijriValue is set to be +2, tiien the user sees the date as being the 26th. 
Typically @advanceHijriValue is +/-1, and this suffices in most cases. Theoretically it can be 
any number, but the worst case scenario is +/-3. 

The /myCalendar/event/@changeNmnber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/evenl/@id (minOccurs=l maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services 
generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useCIientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 
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The /myCalendar/event/@creator (ininOcciirs=l maxOcciirs=l) attribute identifies the 
creator in terms of userld, appld, and platformld of the node. 

The /myCalendar/event/body (minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/body/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute, which is designed to facilitate caching of the element and its descendants. This 
attribute is assigned to this element by the .NET My Services system. The attribute is read 
only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/body/cat (minOccurs^O maxOccurs=unbounded) element is 
used to categorize the element that contains it by referencing either a global category 
definition (in either the .NET Categories service system document or an external resource 
containing category definitions), or by referencing an identity-centered category definition in 
the content document of the .NET Categories service for a particular PUID. 

The /myCalendar/event^ody/cat/@ref (anyURI minOccurs=l maxOccurs=l) attribute 
references a category definition (catDef) element using the rules outlined in the .NET 
Categories section, described above. 

The /myCalendar/evenl/body/title (string minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/body/title/@xmI:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCalendar/event/body/title/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the locaUzed string. Valid values 
are rtl (right to left) and Itr (left to right). 
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The /myCalendar/event/body/fiillDescription (string minOccurs=0 maxOccurs=l) 
element contains a free form, full description of the event. The 

/myCalendar/event/body/fullDescription/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/body/fullDescription/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/body/location (string minOccurs=0 maxOccurs=l) optional 
element contains the event's location. The /myCalendar/eveniybody/location/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myCalendar/event/body/location/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
specifies the default layout direction for the localized string. Valid values are rtl (right to left) 
and Itr (left to right). 

The /myCalendar/event/body/meetingStatus (string minOccurs=0 maxOccurs=l) 
tracks the status of this meeting {not-sent, sent, cancelled}. A regular appointment will not 
have this element. If <meetingStatus> exists, this event should be rendered as a meeting, not 
as an appointment. 

The /myCalendar/event/body/recurrenceld (dateTime minOccurs=0 maxOccurs=l) 
recurrence id indicates the original start time of an occurrence of a recurring master 
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appointment. It is required to identify what instance an exception is modifying, since users 
are allowed to change the start time on an orphan, (wherein an an exception is a modification 
of an instance and an orphan is an exception that is sent as a meeting request on its own). The 
recurrenceld method is stored in UTC. It does not appear in the master schema, except in the 
5 specific case that ao attendee is invited to an instance of a recurring event. Otherwise, 
<recurrenceld> is usually only a part of getCalendarDays. 

The /myCalendar/event/body/IastUpdateTime (dateTime minOccurs=0 maxOccurs=l) 
field is updated by the organizer whenever s/he creates and sends a new meeting request. This 

4 helps the attendee to identify which meeting request is the most recent one. It is stored in 
310 coordinated universal time (UTC). This property is not modifiable by clients and is assigned 
■J by the server on modification and by the sendMeetingRequest. 

5 The /myCalendar/event/body/startTime (dateTime minOccurs=l maxOccurs=l) 

^ startTime method defines the start time of the event. An all-day event by convention starts at 
y 12:00:00 AM of the day of the event. This is stored in UTC. Maximum range is January 1, 
3 15 1753 to December 31, 9999 to an accuracy of 3.33 miUiseconds. If this event is a recurring 
event, <startTime> defines the dateTune when the recurrence window starts. The recurring 
master does not have to be an instance of the recurring event itself An event in March set to 
recur every April will only appear in April. 

The/myCalendar/event/body/endTime (dateTime minOccurs=l maxOccurs=l) 
20 endTime method defines the end time of the event. An all-day event by convention ends at 
1 1:59:59 PM of the ending day. This is stored in UTC. Maximum range is January 1, 1753 to 
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December 31, 9999 to an accuracy of 3.33 milliseconds. The duration of the event is inferred 
fix>m endTime - startTime. 

The /myCalendar/event/body/allDay (boolean minOccurs=0 maxOccurs=l) element 
indicates a regular event by being false or being absent. Otherwise, this attribute mdicates that 
the event is an all-day event. All day events may ^an multiple days. By convention, all day 
events start at 12:00:00 am of Ihe day of startTime, regardless of what time it actually is, and 
it will end at 1 1:59:59 pm of the endTime date, hi other words, if the allDay element is 
present and has value=true, .NET Calendar will ignore the actual times of the events and 
consider only the date part of the field. 

The allDay tag is meant to operate as a hint to UI renders to display specialized icons 
indicating an all-day event. allDay events are distinguishable between 24-hr events starting at 
12am. In the case of a meetmg request, an allDay event will not appear in the local user's 
time zone, but rather in the organizer's time zone. 

The /myCalendar/event/body/floating (boolean minOccurs=0 maxOccurs=l) floating 
attribute indicates that this event is to occur in the current local time zone no matter what time 
zone the system is currently m (that is, it floats). For example, hoUdays are floatmg events. 
As another example, it may be useful to schedule medication regardless of an actual time 
zone, whereby a floating attribute is used with such an event. Floating values are stored as-is: 
no time-zone ti^slations are needed to convert them to UTC or any local time zone. 

The/myCalendar/event/body/travelTimeTo (int niinOccurs=0 maxOccurs=l) field 
contains the amount of time (in minutes) that it takes to ti^vel to the meeting location. The 
/myCalendar/event^ody/ti-avelTimeFrom (int minOccurs=0 maxOccurs=l) field contains the 
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amount of time (in minutes) that it takes to return from the meeting location. These optional 
elements show in free/busy calculations. 

The /myCalendar/event/body/freeBusyStatus (string minOccurs=0 maxOccure=l) 
optional element annotates the freeBusy behavior of this event. Events by default appear as 
"busy". The user may explicitly defme this event to be annotated by setting .NET Calendar 
values to free, tentative, busy or away. 

The /myCalendar/event/body/cuid (string minOccurs=0 maxOccurs=l) cuid 
(CorrelationUID) links an organizer's event to an attendee's event. It identifies which 
response from an attendee is for which request from an organizer, and which meeting request 
update from the organizer is for which previously accepted meeting by the attendee. The 
"cuid" is the same on both the attendee's and the organizer's copy of the appointment. It is 
also identical on the exception and the recurring master, wherein an exception is a 
modification of an instance. This value is assigned by the .NET Calendar server and is non- 
modifiable. 

The /myCalendar/event/body/organizer (minOccurs=0 maxOccurs=l) field contains 
the email address of the event organizer. The /myCalendar/event/body/organizer/name (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The/myCalendar/event/body/organizer/name/@xml:lang (minOccurs=l maxOccurs=l) 
reqmred attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/body/organizer/name/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the default layout direction for the locaHzed string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/body/organizer/puid (string minOccurs=0 maxOccurs=l) 
optional element specifies the PUID for the enclosing element. The 
/myCalendar/event/body/organizer/email (string minOccurs=0 maxOccurs=l) optional name 
specifies an e-mail address for the enclosing element. 

The /myCalendar/event/body/{any} (minOccurs=0 maxOccurs=unbounded) provides 
for additional body elements. 

The /myCalendar/event/attendeeEventExtra (minOccurs=0 maxOccurs=l) field 
contains additional information about an event, found only in an event invitee's schema. The 
/myCalendar/event/attendeeEventExtra/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The ZmyCalendar/event/attendeeEventExtra/intendedFreeBusy (string minOccurs=0 
maxOccurs=l) element is the event organizer's fi*eeBusy information and is thus equal to 
event/fi-eeBusyStatus. Invitees may overwrite event/fi-eeBusyStatus with a new value, and 
intendedFreeBusy is intended to store the organizer's original fireeBusyStatus. 

The /myCalendar/event/attendeeEventExtra/responseTime (dateTime minOccurs==0 
maxOccurs=l) field contains the reply time on each attendee is set to the current time (Now) 
when the organizer sends a meeting invitation. When the attendee responds, they update their 
responseTime. When the organizer receives responses, they will honor only those that have a 
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higher responseTime than what is maintained in his/her own copy of the event for each 
attendee. While processing the response, the organizer will update their responseTime. This 
guarantees that the organizer honors only the most recent response from the attendee. This is 
stored in UTC. 

The /myCalendar/event/attendeeEventExtra/responseType (string minOccurs=0 
maxOccurs=l) accept status indicates the valid types of responses that an attendee can reply 
with {accept, decline, tentative, counterpropose}. The absence of this field indicates that no 
response has been recorded. 

The ZmyCalendar/event/attendeeEventExtra/counterProposeStartTime (dateTime 
minOccurs=0 maxOccurs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the startTime, endTime, or location, or all three 
caa be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. 

The ZmyCalendar/event/attendeeEventExtra/counterProposeEndTime (dateTime 
minOccurs=0 ma?cOccurs=l) field contains the counter proposal end time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC. 

The ZmyCalendar/event/attendeeEventExtra/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field contains the counterproposal location information, field 
contains the counter proposal start time information. If responseType=[counterPropose], then 
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either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 

The /myCalendar/event/attendeeEventExtra/responseBody (string niinOccurs=0 
maxOccurs=l) field contains an optional message for invitees to include along with the 
response. The /myCalendar/event/attendeeEventExtra/responseBody/@xnil:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
/myCalendar/event/attendeeEventExtra/responseBody/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The ZmyCalendar/event/attendeeEventExtra/delegateResponder (minOccurs=0 
maxOccurs=l) field stores information of a delegate who responds on behalf of an invitee. 
The /myCalendar/event/attendeeEventExtra/delegateResponder/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
/myCalendar/event/attendeeEventExtra/delegateResponder/name/(^ml:lang(minOcc^ 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/attendeeEventExtra/delegateResponder/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the defauh layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 
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The /myCalendar/event/attendeeEventExtra/delegateResponder/puid (string 
minOcciirs=0 maxOccurs=l) optional element specifies the PUE) for the enclosing element. 
The /myCalendar/event/attendeeEventExtra/delegateResponder/email (string minOccurs=0 
maxOccurs=l) optional name specifies an e-mail address for the enclosing element. The 
5 /myCalendar/event/attendeeEventExtra/{any} (minOccitrs=0 maxOccurs=unbounded) 
provides for additional attendee extra properties. 

The /myCalendar/event/attachment (minOccurs==0 maxOccxju:s==unboimded) element 
contains attachment metadata, name, content-type and id's, and may also contain the 
attachmentBody. The /myCalendar/event/attachment/@changeNumber (minOcciirs=l 
^ 10 maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
4 descendants. This attribute is assigned to this element by the .NET My Services system. The 
3 attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/attachment/@id (minOccurs=l maxOccurs==l) attribute is a 

3 

y globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

I y 

Q 15 Services generates and assigns this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myCalendar/event/attachment/@creator (minOccurs=l maxOccurs=l) attribute 
20 identifies the creator in terms of userld, appid, aad platformid of the node. The 

/myCalendar/event/attachment/name (string minOccurs=l maxOccurs=l) element contains 
information about an individual attachment in a mail message. The 
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/myCalendar/event/attachment/name/@xml:lang (minOccurs=l maxOcciirs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/attachment/name/@dir (string nunOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (rigjit to left) and Itr (left to right). 

The /myCalendar/event/attachment/contentType (string minOccurs=l maxOccurs=l) 
element contains the content type of the attachment. The 

/myCalendar/event/attachment/contentTransferEncoding (string minOccurs=l maxOccurs=l) 
element contains the encoding of the attachment. This information is necessary for decoding 
the attachment. The /myCalendar/event/attachment/size (unsignedLx)ng minOccurs=l 
maxOccurs=l) element contains the size of the attachment in bytes. The 
/myCalendar/event/attachment/attachmentBody (base64Binary minOccurs=l maxOccurs=l) 
element contains the contents of the attachment. 

The /myCalendar/event/reminder (minOccurs=0 maxOccurs=l) is directed to 
reminders. A user may optionally define a reminder for this appointaient. Reminders for 
recurring appointments will be sent periodically before the appointment, as per the rules 
defined in the reminder subschema below. A non-recurring event may define no reminders, 
define a reminder with <set> = "true*' or define a reminder with <set> = "false". 

A recurring meeting may have no reminders defined, or a recurring reminder defined 
with all instances receiving remuiders. To define no reminders by default, but to define 
reminders for particular meeting instances in the exception body, a reminder <set> = "false" is 
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created, and tvimed on and/or modified for particular instances. To define a recurring 
reminder, but tum it off for particular meeting instances, a reminder <set> = "true" is created, 
and turned off for particular instances. 

If the event's reminder subschema is non-existent, yet the exception body has a 
reminder blob, then the exception reminder is ignored. An altemative is to require this. 

The /myCalendar/event/reminder/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/reminder/@id (minOccurs^l maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Nonnally, .NET My 
Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useCUentlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myCalendar/event/reminder/@creator (minOccurs=l maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/myCalendar/event/reminder/set (boolean minOccurs=l maxOccurs=l) field maintains a 
Boolean flag that indicates whether the reminder is active for this event. In most cases, this 
will be true, but in the case of a recurring appointment, this flag may default to true with 
specific instances not to be reminded, or default to false, with specific instances to be 
reminded. 
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The /myCalendar/event/reminder/to (string minOccurs=l maxOccurs=l) stores a 
friendly name that this reminder is being sent to. The 

/myCalendar/event/reminder/to/@xnil:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCalendar/event/reminder/to/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the locaUzed string. VaUd values 
are rtl (right to left) and Itr (left to right). 



The /myCalendar/event/reminder/offset (int minOccurs=l maxOccurs=l) field 
specifies the offset, in minutes, of how long before the event the user should be reminded. 
Recommended values are set forth in the following table: 



Value 


Description 


5, 10, 20, 30, 45 i 


5,10, 20, 30, 45 minutes before the event 


60, 120, 180, 


1, 2, 3 hours before the event 


startTime - startDay 


The day of the event (reminder sent at 12:00am) 


startTime - (startDay - (1440 * 

X)) 


"x" days before the event (reminder sent at 12:00am "x" 
days before) 



The /myCalendar/event/reminder/interruptability (int minOccurs=0 maxOccurs=l) 
optional element defines how interruptible this event is and it is used by notification routing 
software to make decisions about the relay and deferral of notifications that might occur while 
this meeting is active. The value contained in this element is a numeric value between one 
and ten. Low values represent a high cost of disruption, high values represent a low cost of 
disruption. 
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The /myCalendar/event/reminder/lastSentTime (dateTime minOccurs=l 
maxOccurs=l) field is required by the reminder engine. The 
/myCalendar/event/reminder/nextTriggerTime (dateTime minOccurs=l maxOccurs=l) 
determines the next time to trigger reminder. 

The /myCalendar/event/attendee (minOccurs=0 maxOccurs=unbounded) includes the 
attendeeType, which contains the information about an attendee, includmg the display, email, 

puid, and the attendee's response. 

The /myCalendar/event/attendee/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to faciUtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/attendee/@id (minOccurs=l maxOccurs=l) attribute is a 
globaUy unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The/myCalendar/event/attendee/@creator (minOccurs=l maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. The 
/myCalendar/event/attendee/name (string minOccurs=0 maxOccurs=l) optional element 
specifies the name for the enclosing element. The 

/myCalendar/event/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
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is used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCalendar/event/attendee/name/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
5 are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attendee/puid (string minOccurs=0 maxOccurs=l) optional 
element specifies the PUID for the enclosing element. The /myCalendar/event/attendee/email 
(string minOccurs=0 maxOccurs=l) optional name specifies an e-mail address for the 
enclosmg element. The /myCalendar/event/attendee/inviteType (string minOccurs=l 
10 maxOccurs=l) is used by a meeting organizer to define the kind of invitee, e.g., as required, 
optional, or a resource (e.g., meeting room). 

The /myCalendar/event/attendee/responseTime (dateTime minOccurs=0 
maxOccurs=l) reply time on each attendee is set to the current time (Now) when the organizer 
sends a meeting invitation. When the attendee responds, they update their responseTime. 
1 5 When the organizer receives responses, they will honor only those that have a higher 

responseTime than what s/he maintains in his/her own copy of the event for each attendee. 
While processing the response, the organizer will update their responseTime. This guarantees 
that the organizer honors only the most recent response firom the attendee. This is stored m 
UTC. 

20 The /myCalendar/event/attendee/counterProposeStartTime (dateTime minOccurs=0 

maxOccurs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
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can be present. This is the invitee's counterproposal for a new start time for the meeting. 

This is stored in UTC. 

The /myCalendar/event/attendee/counterProposeEndTime (dateTime minOccurs=0 

maxOcciirs=l) field contains Ihe counter proposal end time information. If 
5 responseType=[counterPropose], then either the {startTime, endTime} , or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC, 

The /myCalendar/event/attendee/counterProposeLocation (string minOccurs=0 
I J, maxC)ccurs=l) field contains the counter proposal location information, field contains the 
ii 1 0 counter proposal start time infbnnation. If responseType=[counterPropose], then either the 
M {startTime, endTime}, orlocation, or both can be present. This is the invitee's 
;: S counterproposal for a location for the meeting. 

I J. The /myCalendar/event/attendee/responseBody (string minOccurs=0 maxOccurs=l) 

r U field contains an optional message for invitees to include along with the response. The 
□ 15 /myCalendar/event/attendee/responseBody/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myCalendar/event/attendee/responseBody/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 
20 neutral text. Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/attendee/{any} (minOccurs=0 maxOccurs=unbounded) allows 
for extensibility. 
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The /myCalendar/event/recurrence (minOccurs=0 inaxOccurs=l) includes 
/myCalendar/evait/reciirrence/@changeNiiinber (ininOccurs=l maxC)cciirs=l) 
changeNumber attribute, designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/recurrence/rule (minOccurs=l maxOccurs=l) includes the 
/myCalendar/event/recuiTence/rula'@changeNumber (minC)ccurs=l maxOccurs=l) 
changeNumber attribute, designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /myCalendar/event/recurrence/nile/creationDate (dateTime minOccurs=l 
maxOccurs=l) is required in order to exactly determine which timezone recurrence rule to 
use. The startTime of the event is not used because of the abiUty to create events in the past 
and in the future. 

The /myCalendar/event/recurrence/rule/firstDayOfWeek (string minOccurs=l 
maxOccurs=l) stores what the first day of the week (DOW) is for this user. Typical values 
are (su) Sunday or (mo) Monday. This maintains a recurrence rule's specified FirstDOW (for 
calculating the recurrence expansion. Allows recurring meetings to be expanded in the 
organizer's FirstDOW instead of the invitee's FirstDOW, 

The /myCalendar/event/recurrence/rale/tzid (int minOccurs=0 maxOccurs=l) 
identifies the time zone for this recurring event. The dateTime information in this event is 
stored in UTC (converted firom the local time zone defined by the time zone sub-schema). If 



-117- 



this field is absent, the recurring event is assumed to be recurring in UTC time. However, it is 
only a floating recurring event if the <floating> attribute is set, as described above. 
@afterDay is currently used, but is optional. 

The /myCalendar/event/recurrence/rule/isLeapYear (boolean minOccurs=0 

5 maxOccurs=l) provides Jhtemational calendar support. It is possible to derive isLeapYear 
firom leapMonthValue, but .NET Calendar stores both separately. The 
/myCalendar/event/recurrence/rale/leapMonthValue (int niinOccurs=0 maxOccurs=l) 
<leapMonthValue> cannot be derived firom a particular year and thus must be stored. For 
example, a user creates a recurrence on a Hebrew Lunar calendar. The year is a leap year and 

10 it has 1 3 monfiis. In that year, the leapMonthValue is 7. 

The /myCalendar/event/recurrence/mle/repeat (minOccurs=l maxOccurs=l) may 
includes the /myCalendar/event/recuirence/rule/repeat/daily (minOccurs=0 maxOccurs=l), 
field, which specifies the number of days to repeat, e.g., repeat every [...] days. The 
/myCalendar/event/recurrence/rule/repeat/daily/@dayFrequency (int minOccurs=l 

1 5 maxOccurs=l) specifies the periodicity of days over which repetition occurs, for example, 
repeat every 3 days. 

The /myCalendar/event/recurrence/rule/repeat/weekly (minOccurs=0 maxOccurs=l) 
field, if present, is directed to repeating weekly, e.g., repeat every [...] week(s) on 
{su,mo,tu,we,th,fir,sa}. The presence of a weekday attribute means to repeat on this particular 
20 day. Any combination of the seven days is valid. 
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The /myCalendar/event/recun-ence/rale/repeat/weekly/@weekFrequen^ (int 
minOccurs=0 maxOccurs=l) repeatWeekly recurrence occurs every period of weeks. If the 
attribute is not present, it defaults to 1 (every week). 

The /myCalendar/event/recurrence/rule/repeat/monthlyByDay (minOccurs=0 
maxOccurs=l) specifies to repeat on the [First, Second, Third, Fourth, Last] {su, mo, tu, we, 
th, fr, sa} of every [...] month(s). Any combination of the {weekday} attributes are valid, 
including user-defined combinations for weekdays and weekend days. 

The /myCalendar/event/recurrence/rule/repeat/monthlyByDay/@monthFrequency (int 
minOccurs=0 maxOccurs=l) specifies the month periodicity to recur on. If this attribute is 
not present, it defaults to 1 (every month). 

The/myCalendar/event/recurrence/rule/repeat/monthlyByDay/@weekdayOfM 

(string minOccurs=l maxOccurs=l) specifies which week in a month [fn-st, second, third, 
fourth, last]. 

The /myCalendar/event/recurrence/rule/repeat/monthly (minOccurs=0 maxOccurs=l) 
repeats the occurrence every month on a particular day. The very first occurrence is created 
from the parent event's startTime and endTime, but the recurrence occurs as follows: Repeat 
every month on [day] of [month]. Repeat every [monthFrequency] month(s) on [day] of 
[month]. Typically, the first occurrence is also an instance of the recurrence, but this need not 
be the case. 

The /myCalendar/event/recurrence/rule/repeat/monthly/@monthFrequency (int 
minOccurs=0 maxOccurs=l) optional attribute indicates the month periodicity. By default, it 
is 1, periodic every month. The start of the periodicity is determined from event startTime, 
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The /myCalendar/event/recurrence/rale/repeat/monthly/@d^^ (int ininOccurs=l 
maxOcciirs=l) specifies the day of the month to recur on. Value is between one and 31 . 

A forceExact rule handles invalid day-month combinations. The proper recurrence 
pattern for repeating on the last day of the month is to use repeatMonthlyByDay. "Repeat on 
5 the [last] [day, weekday, weekend day] of By default, an invalid day-month combination 
will cause .NET Calendar to search backwards to find a valid day-month combination. If 
/myCalendar/event/recurrence/rule/repeat/monthly/@forceExact (boolean minOccurs=0 
maxOccurs=l) is true, an invalid starting [month 4ay] combination such as [6, 31] is ignored 
and will not be included as an instance of the recurrence. With forceExact, day=31 will only 

i;3 10 pick up months that have 3 1 days, day=30 will pick up all months except February, day=29 

U 

"''4 will pick up all months except February, except on leap years. February 29 is included on 
j;^ leap years. 

I The /myCalendar/event/recurrence/rule/repeat/yearlyByDay (minOccurs=0 

lU maxOccurs=l) specifies how to repeat on the [First, Second, Third, Fourth, Last] {su, mo, tu, 
i - 15 we, th, fr, sa} of [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec] every 
[yearFrequency] years. 

Any combination of the {weekday} attributes are vaUd, including user-defined 
combinations denoting weekdays and weekend days. This element's attributes contain 
whether a given day is or is not considered by the user as part of the work week. If this 
20 element has no attributes, it is assumed that the user has a Monday to Friday work week. 
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Tlie/myCalendar/event/recurrence/rule/repeat/yearlyByDay/@yearFrequency(int 

minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, it is 

1 (repeat every year). 

The/myCalendar/event/recurrence/rule/repeat/yearlyByDay/@weekdayOfMonth 

5 (string minOccurs=l maxOccurs=l) Specifies which week in a month [first, second, third, 

fourth, last] to repeat. 

The /myCalendar/event/recurrence/rule/repeat/yearlyByDay/@month (int 

minOccurs=l maxOccurs=l) contains a value between one and thirteen (some calendars have 

thirteen months). 

i3lO The /myCalendar/event/recurrence/rule/repeat/yearly (minOccurs=0 maxOccurs=l) 

' 4 specifies to repeat every year on a particular date. The very first occurrence is created fi-om 
:;2 the parent event's startTime and endTime, but the recurrence occurs as follows: Repeat yearly 
U on [day] of [month]. Repeat every [yearFrequency] years on [day] of [month]. Typically, the 
m first occurrence is also an instance of the recurrence, but this need not be the case. 

Q 15 The /myCalendar/event/recurrence/rule/repeat/yearly/@yearFrequency (int 

U 

minC)ccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, it is 
1 (repeat every year). The /myCalendar/event/recurrence/rule/repeat/yearly/@month (int 
minOccurs=l maxOccurs=l) specifies the month to recur on. 

The /myCalendar/event/recurrence/rule/repeat/yearly/@day (int minOccurs=l 
20 maxOccurs=l) specifies the day of the month to recur on. The value is between 1-31, and 
forceExact, applies for invalid day-month combinations. Thus, by default, an invalid day- 
month-year combination will cause .NET Calendar to search backwards to find a vahd day for 
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a particular month, year. If /myCalendar/event/recurrence/rule/repeat/yearly/@forceExact 
(boolean mmOccurs=0 maxOccurs=l) is true, an invalid starting [month ,day] combination 
such as [6, 31] is ignored and will not be included as an instance of the recurrence. With 
forceExact, .NET Calendar, day=31 will only pick up months that have 31 days, day=30 will 
5 pick up all months except February, day=29 will pick up all months except February, except 
on leap years. February 29 is included on leap years. 

The /myCalendar/event/recurrence/rule/repeal/{any} (minOccurs=0 
maxOccurs=unbounded) allows for any additional repeat rules. 

The /myCalendar/event/recurrence/rule/windowEnd (dateTime minOccurs=0 
10 maxOcciirs=l) field indicates the end of the window over which the recurrence occurs. This 
is stored in UTC. The Maximum range is January 1, 1753 to December 31, 9999 to an 
accuracy of 3.33 milliseconds. Note that windowEnd, repeatForever, repeatlnstances may be 
selectable. 

The /myCalendar/event/recurrence/rule/repeatForever (boolean minOccurs=0 
1 5 maxOccurs=l) overrides the windowEnd date and specifies that this recurrence repeats 
forever. Client implanentations cannot depend on date values repeating forever, like 
23:59:59pm Dec 31, 9999 or 23:59 Aug 31, 4500. 

The /myCalendar/event/recurrence/rule/repeatlnstances (int minOccurs=0 
maxOccurs=l) overrides the windowEnd date and specifies that this recurrence repeats for the 
20 specified number of instances. As is apparent, repeatitastances and repeatForever are mutually 
exclusive, but repeathistances will override repeatForever for errant schemas. 
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The /myCalendar/event/recurrence/rule/deletedExceptionDate (dateTime 
minOccurs=0 maxOccurs=unbounded) allows exceptions to a recurrence rule, which are 
added as an element Ust of dates. In general, the purpose of deletedExceptionDate is to 
prevent an instance/occurrence from being generated during expansion of the series. The 
myCalendar service logic ignores the hh:mm:ss of the dateTime and merely blocks out the 
particular day. Any days can be added to an exception rule, mcluding days where no 
occurrences of a recurrence rule would fall in the first place. This is stored in UTC. 

The /myCalendar/event/recurrence/rule/{any} (minOccurs=0 maxOccurs=unbounded) 
provides for additional recurrence rule logic that cannot be expressed in .NET Calendar logic. 

The /myCalendar/event/recurrence/exception (minOccurs=0 maxOccurs=unbounded) 
field contains a list of modified event properties for this particular orphan event. The 
properties that are not modified are inherited from the origmal event upon recurrence 
expansion (client-side). A recurrenceld is dways present, and is used to determine which 
instance of the original rule this modifiedException applies to. 

The /myCalendar/event/recurrence/exception/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The/myCalendar/event/recurrence/exception/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services generates and assigns this ID during an insertRequest operation or possibly 
during a replaceRequest. Application software can override this ID generation by specifying 
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the useClientlds attribute in the request message. After an ID has been assigned, the attribute 
is read only and attempts to write it are silently ignored. 

The /myCalendar/event/recurrence/exception/@creator (minOccurs=l maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformld of the node. The 
5 /myCalendar/event/recurrence/exception/recurrenceld (dateTime minOccurs=l maxOccurs=l) 
field contains the origmal start time (recurrenceld) of the occurrence that is being modified by 
this exception. ModifiedExceptions with recurrencelds that do not match the recurrenceld of 
any occurrence are ignored. This is stored in UTC. Note that modifiedException does not 

U expose tiie id attribute; the recurrenceld should be used to predicate instead, as it functions as 

□ 1 0 the id of modifiedException, 

SI The /myCalendar/event/recurrence/exception/body (minOccurs=0 maxOccurs=l) field 

:;2 contains the modifiable properties of the evenlBody. The 

U /myCalendar/event/recurrence/exception/body/title (string minOccurs=0 maxOccurs=l) 

I!" 

i y allows for title changes. The /myCalendar/event/recurrence/exception/body/title/@xml:lang 
f 3 15 (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 

the language type of the content within this element. The 

/myCalenda^/event/recu^rence/exception^ody/title/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
20 are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exceptioa'body/fulDescription (string 
minOccurs=0 maxOccurs==l) provides for a a revised description. The 
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/myCalendar/event/recurrence/excq)tion/body/flUlDescription/@xm^ 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 
5 /myCalendar/event/recurrence/exception/body/fullDescription/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/body/location (string minOccurs=0 
maxOccurs=l) allows for a meeting location to be switched, for this instance only (not 
10 recurring instances). The /myCalendar/event/recurrence/exception/body/location/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
/myCalenda^/event/^ecuIrence/exception^ody/location/@dir (string minOccurs=0 
15 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendai/event/recurrence/exception/body/startTime (dateTime minOccurs=0 
maxOccurs=l), if present, switches the start time, again for this instance only. The 
/myCalendar/event/recurrence/exception/body/endTime (dateTime minOccurs=0 
20 maxOccurs=l) switches the end time for this instance only. 

The /myCalendar/event/recurrence/exception^ody/allDay (boolean minOccurs=0 
maxOccurs=l) specifies that this particular instance is allDay. The 
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/myCalendar/event/recurrence/exception^ody/travelTimeTo (int minOccurs=0 maxOccurs=l) 
can adjust the travel to time for this instance, such as if traffic is a problem. The 
/myCalendar/event/recurrence/exception/body/travelTimeFrom (int minOccurs=0 
maxOccurs=l) can adjust the travel from time for this instance. 

The /myCalendar/event/recurrence/exception/body/freeBusyStatus (string 
minOccurs=0 maxOccurs=l) handles a priority is changed for this meeting instance. 

The /myCalendar/event/recurrence/exceptio^^ody/organizer (minOccurs==0 
maxOccurs=l) field will be present when the original organizer is replaced by another 
organizer. 

The /myCalendar/event/recurrence/exception/body/organizer/name (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The /myCalendar/event/recurrence/exception/body/organizer/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or m ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception^ody/organizer/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
VaUd values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/body/organizer/puid (string 
minOccurs=0 maxOccurs=l) optional element specifies the PUID for the enclosing element. 
The /myCalendar/event/recurrence/exception/body/organizer/email (string minOccurs=0 
maxOccurs=l) optional name specifies an e-mail address for the enclosing element. The 
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/myCalendar/event/recurrence/exception/attendeeEventExtra (minOccurs=0 niaxOccurs=l ) 
provides for additional information about an event, found only in an event invitee's schema. 

The/myCalendar/event/recurrence/exception/attendeeEventExtra/intendedFreeBusy 
(string minOccurs=0 maxOccurs=l) intendedFreeBusy element is the event organizer's 
freeBusy information, and is thus equal to event/freeBusyStatus. Invitees may overwrite 
event/freeBusyStatus with a new value, and intendedFreeBusy is intended to store the 
organizer's original freeBusyStatus. 

The/myCalendar/event/recurrence/exception/attendeeEventExtra/responseTime 
(dateTime minOccurs=0 maxOccurs=l) reply time on each attendee is set to the current time 
(Now) when the organizer sends a meeting invitation. When the attendee responds, they 
update their responseTime. When the organizer receives responses, they will honor only those 
that have a higher responseTime than what is maintained in his/her own copy of the event for 
each attendee. While processing the response, the organizer will update their responseTime. 
This guarantees that the organizer honors only the most recent response from the attendee. 
This is stored in UTC. 

The /myCalendar/event/recurrence/exception/attendeeEventExtra/responseType (string 
minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
attendee can reply with {accept, decline, tentative, counterpropose} . The absence of this field 
indicates that no response has been recorded. 

The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeStartTime 
(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal start time 
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information. If responseType=[counterPropose], then either tJie {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new start time for 
the meeting. This is stored in UTC. 
The 

5 /myCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeEndTime 
(dateTime minOccurs=0 maxOcciirs=l) field contains the counter proposal end time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new end time for 
the meeting. This is stored in UTC. 

10 The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field contains the counter proposal location information, field 
contains the counter proposal start time information. If responseType=[counterPropose], then 
either the {startTime, endTime} , or location, or both can be present. This is the invitee's 

1 5 counterproposal for a location for the meeting. 

The/myCalendar/event/recurrence/exception/attendeeEventExtra/responseBody 

(string minOccurs=0 ma!cOccurs=l) field contains an optional message for invitees to include 

along with ttie response. The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/responseBody/@xml:lang 
20 (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
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/myCalendar/event/recurrence/exceptioiVattendeeEventExtra/responseBody/@dir(stri^ 
ininOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 
neutral text. Possible values include rtl (right to left) and Itr (left to right). 

The/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder 

(minOccurs=0 maxOccxu^i=l), when present,is for a delegate who responds on behalf of an 
invitee; the delegate will have their information stored hare. 
The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/name (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/name/@xml: 
lang (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language 
code or an ISO 3166 country code as described in RFC 1766. The value of this attribute 
indicates the language type of the content within this element. The 

/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/name/@dir 
(string minOccurs=0 maxOccurs=l) optional attribute specifies tiie default layout direction for 
the localized string. Valid values are rtl (right to left) and Itr (left to right). 
The 

ZmyCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/puid (string 

minOccurs^O maxOccurs=l) optional element specifies the PUID for the enclosing element. 
The/myCalendar/event/recurrence/exception/attendeeEventExtra/delegateResponder/email 
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(string mmOcciirs=0 maxOccurs=l) optional name specifies an e-mail address for the 
enclosing element. 

The /myCalendar/event/recurrence/exception/attendeeEventExtra/{any} (minOccurs=0 
maxOccurs===unbounded) allows for additional attendee extra properties. 

The meeting organizer of a recurring meeting may wish to exclude a particular 
attendee for an instance of the meeting. This idRefType (puid) indicates which attendee, 
(from the list of attendees at the event level) are not invited to this particular meeting instance, 
as specified in /myCalendar/event/recurrence/exception/deletedAttendee (string minOccurs=0 
maxOccurs=unbounded). The /myCalendar/event/recurrence/exception/deletedAttachment 
(string minOccurs=0 maxOccurs=unbounded) is used when the meeting organizer of a 
recurring meeting may wish to exclude a particular attachment for an instance of the meeting. 

The /myCalendar/event/recurrence/exception/attachment (minOccurs=0 
maxOccurs=nmbounded) specifies the scheme the message contents were encoded in. 
Examples of this are '7bit', *8bit' and 'base64'. 

The /myCalendar/event/recurrence/exception/attachment/name (string minOccurs=l 
maxOccurs=l) element contains information about an individual attachment in a mail 
message. The /myCalendar/event/recurrence/exception/attachment/name/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myCalendar/event^recurrence/exception/attachment/name/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/attachment/contentType (string 
ininOccurs=l maxOccurs=l) element contains the content type of the attachment. 

The/myCalendar/event/recurrence/exception/attachment/contentTransferEncoding 
(string minOccurs=l maxOccurs=l) element contains the encoding of the attachment. This 
information is necessary for decoding the attachment. 

The /myCalendar/event/recurrence/exception/attachment/size (unsignedLong 
minOccurs=l maxOccurs=l) element contains the size of the attachment in bytes. 

The /myCalendar/event/recurrence/exception/ attachment/attachmentBody 
(base64Binary minOccurs=l maxOccurs=l) element contains the contents of the attachment. 

The /myCalendar/event/recurrence/exception/attendee (minOccurs=0 
maxOccurs=unbounded) attendeeType contains the information about an attendee, including 
the display, email, puid, and the attendee's response. 

The /myCalendar/event/recurrence/exception/attendee/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
/myCalendar/event/recurrence/exception/attendee/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myCalendar/event/recurrence/exception/attendee/name/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myCalendar/ event/recurrence/ exception/ attendee/puid (string minOccurs=0 
maxOccurs=l) optional element specifies the PUID for the enclosing element, 
5 The /myCalendar/event/recurrence/exception/attendee/email (string minOccurs=0 

maxOccurs=l) optional name specifies an e-mail address for the enclosing element. 

The /myCalendar/event/recurrence/exception/attendee/inviteType (string minOccurs=l 
maxOccurs=l) is used by the meeting organizer to define the kind of invitee {required, 
optional, resource} . 

i; 3 1 0 The /myCalendar/event/recurrence/exception/attendee/responseTime (dateTime 

minOccurs=0 maxOccurs=l) is for the reply time. The reply time on each attendee is set to 

1:2 the current time (Now) when the organizer sends a meeting invitation. When the attendee 
responds, they always update their responseTime. When the organizer receives responses, 

□ 

rlj they will honor only those that have a higher responseTime than what s/he maintains m 
O 15 his/her own copy of the event for each attendee. While processing the response, the organizer 
will update their responseTime. This guarantees that the organizer honors only the most 
recent response firom the attendee. This is stored in UTC. 

The /myCalendar/event/recurrence/exception/attendee/responseType (string 
minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
20 attendee can reply with {accept, decline, tentative, counterpropose}. The absence of this field 
indicates that no response has been recorded (either the invitation has not been sent, or that a 
reply has not been received). 
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The/myCalendar/event/recurrence/exception/attendee/counterProposeStartTime 
(dateTime minOcciirs=0 maxOccurs=l) is like other counter proposal data. Thus, If 
responseType=[counterProposel, then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. The 

/myCalendar/event/recurrence/exception/attendee/counterProposeEndTime (dateTime 
minOccurs=0 maxOccurs=l) is for the counter-proposed end time, and if 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new end time for the meetmg. This 
is stored in UTC. The 

/myCalendar/event/recurrence/exception/attendee/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field is for the counter-proposed location. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a location for the meeting. 

The /myCalendar/event/recurrence/exception/attendee/responseBody (string 
minOccurs=0 maxOccurs=I) provides for an optional message for invitees to include along 
witfi the response. The 

/myCalendar/event/recurrence/exception/attendee/responseBody/@xml:lang(minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of Ihe content within tiiis element. The 

/myCalendar/event/recurrence/exception/attendee/responseBody/@dir(stiingminOccurs=0 
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maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /myCalendar/event/recurrence/exception/attendee/{any} (minOccurs=0 
maxOccurs=unbounded) field provides extensibility. 

The /myCalendar/event/recurrence/exception/reminder (minOccurs=0 maxOccurs=l) 
are the properties of the remmder that may be modified. If there is no reminder subschema in 
the event body, exception reminders are ignored. 

The /myCalendar/event/recurrence/exception/reminder/set (boolean minOccurs=0 
maxOccurs=l), /myCalendar/evenf recurrence/exception/reminder/ofrset (int minOccurs=0 
maxC)ccurs=l) and /myCalendar/event/recurrence/exception/reminder/interruptability (int 
minOccurs=0 maxOccurs=l), are generally as described above, however note that these fields 

are for exceptions. 

The /myCalendar/event/recurrence/exception/{any} (nunOccurs=0 
maxOccurs=unbounded) provides for additional properties of the myCalendar/BaseEventType 
schema. 

The/myCalendar/event/recurrence/{any} (minOccurs=0 maxOccurs=unbounded) 
provides for additional recurrence rale elements. 

The /myCalendar/subscription (minOccurs=0 maxOccurs=unbounded) element defines 
a subscription node as described above in the subscription section. 
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mvCalendar /Domain Specific Methods 

In addition to the standard methods, the myCalendar service supports the domain- 
specific methods, getCalendarDays, getFreeBusyDays, getQuickView, sendMeeting, respond 
5 and updateReminder. 

The myCalendar/getCalendarDaysRequest is a calendar date range event generator. 
This method is accessed using a request message, and in response may generate a response 
message or a SOAP Fault message. The following sample document fragments illustrate the 
structure and meaning of the elements and attributes in the request and response messages. 
i3 1 0 The following is a request message XML fragment for getCalendarDays; it takes a startDate 
' and an endDate to define the duration over which calendar events are returned: 



<m:getCalendarDaysRequest 
xmlns:m="http://schemas.microsoft.coni/hs/2001/10/myCalendar" 

xnilns:hs="http://schemas.microsoft.coni/hs/2001/10/core">i..i 
<m:calendarType>o..i</m:calendarType> 
<m:startTime>i..i</m:startTime> 
<m:endTime>i..i</m:endTime> 
<m:removeRecurrence>o..i</m:removeRecurrence> 
</m:getCalendarDaysRequest> 

The /getCalendarDaysRequest (minOccurs=l maxOccurs=l) function returns an XML 
stream of calendar appointments / events between two dates. Recurrence rules are expanded 
1 5 to create individual calendar items. Holidays are represented as all-day events, and these are 
returned as well. The getCalendarDays method is a query-retrieval of data, but the behavior 
expands recurrence rules into individual (aliased) events, adds in holidays, and adds regular 
events and sorts the entire list based on start time. No merging of event blocks occurs. Any 
object which overiaps the method parameters {startTime, endTime} will be returned. For 
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example, if an event crosses midnight and the startTime is 12am, that event will be returned. 
In case the startDate, endDate is one day, the events are sorted in the following order: 
holidays, all-day events, and regular events (based on startTime). The {startTime, endTime] 
time window can define any interval: 24hr period, week, month, or any other user-defined 
period. 

The getCalendarDays melhod returns the calendaring info of any puid that is specified 
for which the cdler has sufficient privileges. The user's own puid must be specified to retrieve 
their own information. The getCalendarDays method may be used to retrieve multiple 
calendar data firom other users using <h:key instance="0" cluster="0" puid="xyz7> in the 
SOAP headers provided that puid "xyz" is provisioned on the .NET Calendar server, and 
provided that the user has been granted access in puid "xyz"'s roleUst. 

The /getCalendarDaysRequest/calendarType (string minOccurs=0 maxOccurs=l) 
optionally specifies the calendar type to return, as set forth in the calendar-types table above. 
The system defaults to Gregorian if not specified. 

The /getCalendarDaysRequest/startXime (dateTime minOccurs=l maxOccurs=l) 
specifies the starting time window of calendar objects to retrieve. This dateTfane also contains 
the timeZone to retrieve the calendar information in. 

The/getCalendarDaysRequest/endTime (dateTime minOccurs=l maxOccurs=l) field 
contains the ending time window to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in, and needs to be the same timeZone as 
StartTime. 



-136- 



Normally, the recurrence sub-schema, (minus modifiedException and minus 
deletedExceptionDate components) is returned with each instance of a recurring event, like 
"recurring-instance" and "recurring-exception". This allows cUents to properly render the 
recurrence pattern without having to explicitly query the recurring-master. However, because 
it is heavy on bandwidth, .NET Calendar includes the option to not retum this data, via 
/getCalendarDaysRequest/removeRecurrence (boolean minOccurs=0 maxOccurs=l). 

Upon successful completion of the above method, a response message, 
myCalendar/getCalendarDaysResponse, is generated. In the response, calendar events are 
retumed with their recurrence rules expanded mto first-class events. These events have aUased 
PUIDs, logically as part of the same event. Recurrence information is stripped firom the 
original event. The following is a response schema outUne: 



<m:getCalendarDaysResponse selectedNodeCount="..." status="..." 
xinlns:m="http://schemas.microsoft.coni/hs/2001/10/myCalendar" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:event instanceType=",.." calendarType="..." advanceHijriValue="..." changeNumber=".,." 

id="..." creator="...">o..unbounded 

<m:body changeNumber="...">i..i 
<m:cat ref='\..">o..unbounded</m:cat> 
<m:title xml:lang="..." dir="...">i..i</m:title> 
<m:fiillDescription xml:lang="..." dir="...">o..i</m:fullDescription> 
<m:location xml:lang=",..'' dir="...">o..i</m:location> 
<m:meetingStatus>o..i</m:meetingStatus> 
<m:recurrenceId>o..i</m:recurrenceId> 
<m:lastUpdateTime>o..i</m:lastUpdateTime> 
<m: startTime> i i </m: startTime> 
<m:endTime>i i</m: endTime> 
<m:allDay>o..i</m:allDay> 
<m:floating>o..i</m:floatmg> 
<m:travelTimeTo>o..i</m:travelTimeTo> 
<m:travelTimeFrom>o..i</m:travelTimeFrom> 
<m:freeBusyStatus>o..i</m:freeBusyStatus> 
<m:cuid>o..i</m:cuid> 
<m:organizer>o..i 

<hs:name xml:lang="..." dir=''...''>o..i</hs:name> ^ 
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<hs:puid>o..i</hs:puid> 

<hs:email>o..i</hs:email> 
</m:organizer> 
{any} 
</m:body> 

<m:attachment>o..unbounded 

<m:name xml:lang="..." dir="...">i..i</m:name> 
<m:contentType>i.. i</m:contentType> 
<m:contentTransferEncoding>i..i<ym:contentTmnsferEncodin 

<m:size>i..i</m:size> 

<m:attachmentBody>i..i</m:attachmentBody> 
</m:attachment> 
<m:reininder>a.i 

<m: set>i i </m: set> 

<m:to xml:lang=".,." dir="..,">i..i</m:to> 
<m:offset>i..i</m:offset> 
<m:intermptability>o..t</m:interruptability> 
<m:lastSentTime>i..i</m:lastSentTime> 
<m:nextTriggerTime>i.,i</m:nextTriggerTime> 
</m:reminder> 

<m: attendee>o..iinbounded 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 
<hs:puid>o..i</hs:puid> 
<hs:email>o..i</hs:email> 
<m : in viteTyp e> i . . i </m: invi teType> 
<m:responseTime>o..i</m:responseTime> 
<m:responseType>o.. i</m:responseType> 
<m:counterProposeStartTime>o„i</m:counterProposeStartTime> 
<m:counterProposeEndTime>o..i</m:counterProposeEndTime> 
<m:counterProposeLocation>o..i<^/in:counterProposeLocation> 
<m:responseBody xml:lang="..." dir="...'>o..i</m:responseBody> 
{any} 
</m:attendee> 
<m:recurrence>o..i 
<m:rule>i..i 

<m: creatiorLDate>i .,i</m: creationDate> 

<m:firstDayOfWeek>i..i</m:firstDayOfWeek> 

<m:tzid>o..i</m:1:zid> 

<m:isLeap Year>o.. i </m: isLeap Year> 

<m:leapMonthValue>o..i</m:leapMonthValue> 

<m:repeat>i..i 

<m:daily dayFrequency="...">o..i</tn:daily> 

<m:weekly su-"..." mo="..." tu="..." we="..." th="..." fr="..." sa="..." 
weekFrequency="...">o..i</ni:weekly> 

<m:monthlyByDay su=" mo="..;' tu=",.." we-"..." th="..." fr="..." sa="..." 
mont]iFrequency=". . weekdayOfMonth=" . . .">o.. i</ni:monthlyByDay> 

<m:monthly monthFrequency="..." day="..." forceExact="...">o..i</m:monthly> 
<m:yearlyByDay su="..." mo=".,." tu=="..." we="..." th="...» fr="..." sa="..." 
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yearFrequency='\./' weekdayOMonth- month='\.;'>o.a</m:yearlyBy 

<m:yearly yearFrequency="..." month="..." day^"..." forceExact="...">o..i</m:yearly> 
{any} 
</m:repeat> 

<m:windowEnd>o..i</m:windowEnd> 
<m:repeatForever>o.. i*^/m:repeatForever> 
<m:repeatInstances>o..i</in:repeatInstances> 
</m:rule> 
</m:recurrence> 
</m:event> 

</m:getCalendarDaysResponse> 



The /getCalendarDaysResponse (mmOccurs=l maxOcciirs=l) response XML blob 
format, comprises the base event type minus recurrence. The 

/getCalendarDaysResponse/@selectedNodeCount (int minOcciirs=0 maxOccurs==l) This 
attribute is used to return the number of selected nodes, selected by the corresponding data 
language operation. The /getCalendarDaysResponse/@status (string minOccurs=l 
maxOccurs=l) attribute indicates the status of the method. 

If the status is success, the corresponding method was completed successfully. If the 
status is failure, the corresponding method was not completed successfully. If the status is 
rollback, the method failed, but was rolled back to its pre-updateBlock status. If the status is 
notAttempted, the corresponding method was not attempted. This occurs when a previous 
operation failed. 

The /getCalendarDaysResponse/event (minOccurs=0 maxOccurs=unbounded) , if 
present, may have a /getCalendarDaysResponse/event/@instanceType (string minOccurs=0 
maxOccurs=l) field which distinguishes between a single instance of an event or an instance 
of a recurring event. The recurring instance is a modified exception if eventBody/recurrenceld 
is present: single, recurring-master, recurring-instance, recurring-exception. The 
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/getCalendarDaysResponse/event/@calendarType (string minOccurs=0 maxOcciirs=l) field 

I 

identifies an enumeration which determines the kind of calendar event this is, as set forth in 
the above calendar type table. 

The /getCalendarDaysResponse/event/@advanceHijriValue (int minOccurs=0 
5 maxOcciirs=l) field is required for Hijri calendar support. @advanceHijriValue ranges from 
{-3,-2,-1,1,2,3} and is added to the current date, but the day of the week stays the same. For 
example, if today is the 24th and @advanceHijriValue is set to be +2, then the user sees the 
date as being the 26th. Typically @advanceHijriValue is +/-1, and this suffices in most cases. 
Theoretically it can be any number, but the worst case scenario is +/-3. 
Q 10 The /getCalendarDaysResponse/event/@changeNumber (minOcciu-s=l maxOccurs=l) 

changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

□ 

fIJ The /geCalendarDaysResponse/event/@id (minOccurs=l maxOccurs=l) attribute is a 

15 globally unique ED assigned to this element by .NET My Services. Normally, .NET My 

Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 
20 The /getCalendarDaysResponse/event/@creator (minOccurs=l maxOccurs=l) 

attribute identifies the creator in terms of userld, appid, and platformid of the node. 
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The /getCalendarDaysResponse/event/body (minOccurs=l maxOccurs=l) includes the 
/getCalendarDaysResponse/event/body/@changeNuinber (minOccurs=l maxOcciirs=l) 
changeNumber attribute, which is designed to facihtate caching of the element and its 
descendants. This attribute is assigned to this elenient by the .NET My Services system. The 
5 attribute is read only to applications. Attempts to write this attribute are silently ignored. 
The /getCalendarDaysResponse/event/body/cat (minOccurs=0 
maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing either a global category definition (in either the .NET Categories service system 
, ^ document or an extemal resource containing category definitions), or by referencing an 
Q 10 identity-centered category definition in the content document of the .NET Categories service 
J for a particular PUID. 

The /getCalendarDaysResponse/event/body/cat/@ref (anj^URI minOccurs=l 

j'^^ maxOccurs=l) attribute references a category definition (catDef) element using the rules 

□ 

i y outlined in the .NET Categories section, described above. 

Hi 

p 1 5 The /getCalendarDaysResponse/event/body/title (string minOccurs=l maxOccurs=l) 

includes the /getCalendarDaysResponse/event/body/title/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /getCalendarDaysResponse/event/body/title/@dir 
20 (string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left) and Itr (left to right). 
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The /getCalendarDaysResponse/event^ody/fllllDescription (string minOccurs=0 
maxOcciirs=l) element contains a free fom, full description of the event. The 
/getCalendarDaysResponse/event/body/fidlDescription/@xml:lang(niinOccm^ 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
5 country code as described in RFC 1766. The value of this attribute indicates the language 
type ofthe content within this element The 

/getCalendarDaysResponse/event/body/fullDescription/@dir (string minOccurs=0 

maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 

Possible values include rtl (right to left) and Itr (left to right). 
1:3 10 The /getCalendarDaysResponse/event/body/location (string minOccurs=0 

' jf maxOccurs=l) optional element contains the event's location. The 

/getCalendarDaysResponse/event^ody/location/@xml:lang (minOccurs=l maxOccurs=l) 

j; 

j,^^ required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
I y described in RFC 1766. The value of this attribute indicates the language type ofthe content 
|;3 15 within this element. The /getCalendarDaysResponse/event/body/location/@dir (string 

minOccurs==0 maxOccurs=l) optional attribute specifies the default layout direction for the 
locahzed string. Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/body/meetingStatus (string minOccurs=0 
maxOccurs=l) tracks the status of this meeting {not-sent, sent, cancelled}. A regular 
20 appointment will not have this element. If <meetingStatus> exists, this event should be 
rendered as a meeting, not as an appointment. 
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The /getCalendarDaysResponse/event/body/recurrenceld (dateTime minOccurs=0 
maxOccurs=l) recurrence id indicates the original start time of an occurrence of a recurring 
master appointment. It is required to identify what instance an exception is modifying, since 
users are allowed to change the start time on the orphan. The recurrenceld method is stored in 
5 UTC. It does not appear in the master schema, except in the specific case that an attendee is 
invited to an instance of a recurring event. Otherwise, <recurrenceld> is usually only a part of 
getCalendarDays. 

The /getCalendarDaysResponse/event/body/lastUpdateTime (dateTime minOccurs=0 
. . maxOccurs=l) field is updated by the organizer whenever s/he creates and sends a new 
i;5 10 meeting request. This helps the attendee to identify which meeting request is the most recent 
Si one. It is stored in coordinated universal time (UTC), This property is not modifiable by 
clients and is assigned by the server on modification and by the sendMeetingRequest. 
The ZgetCalendarDaysResponse/event/body/startTime (dateTime minOccurs=l 
j y maxOccurs=l) startTime method defines the start time of the event. An all-day event by 
i;3 15 convention starts at 12:00:00 AM of the day of the event. This is stored in UTC. Maximum 
range is January 1, 1753 to December 31, 9999 to an accuracy of 3.33 milliseconds. If this 
event is a recurring event, <startTime> defines the dateTime when the recurrence window 
starts. The recurring master does not have to be an instance ofthe recurring event itself. An 
event in March set to recur every April will only ^ear in April. 
20 The /getCalendarDaysResponse/event/body/endTime (dateTime minOccurs=l 

maxOccurs=l) endTime method defines the end time ofthe event. An all-day event by 
convention ends at 1 1 :59:59 PM of the ending day. This is stored in UTC. Maximum range 
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is January 1, 1753 to December 31, 9999 to an accuracy of 3.33 milliseconds. The duration of 
the event is inferred from endTime - startTime. 

The /getCalendarDaysResponse/event^ody/allDay (boolean minOccurs=0 
maxOccurs=l) element indicates a regular event by being false or being absent. Otherwise, 
this attribute indicates that the event is an all-day event. All day events may span multiple 
days. By convention, all day events start at 12:00:00 am of the day of startTime, regardless of 
what time it actually is, and it will end at 1 1 :59:59 pm of the endTime date. In other words, if 
the allDay element is present and has value=true, .NET Calendar will ignore the actual times 
of the events and consider only the date part of the field. 

The allDay tag is meant to operate as a hint to UI renders to display speciaUzed icons 
indicating an all-day event. allDay events are distinguishable between 24-hr events starting at 
12am. In the case of a meeting request, an allDay event will not appear in the local user's 
time zone, but rather in the organizer's time zone. 

The /getCalendarDaysResponse/event/body/floating (boolean minOccurs=0 
maxOccurs=l) floating attribute indicates that this event is to occur in the current local time 
zone no matter what time zone the system is currently in (that is, it floats). For example, 
hohdays are floating events. As another example, it may be useful to schedule medication 
regardless of an actual time zone, whereby a floating attribute is used with such an event. 
Floating values are stored as-is: no time-zone translations are needed to convert them to UTC 
or any local time zone. 

The /getCalendarDaysResponse/event/body/travelTimeTo (int minOccurs=0 
maxOccurs=l) field contains the amount of time (in minutes) that it takes to travel to the 
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meeting location. The /getCalendarDaysResponse/event/body/travelTimeFrom (int 
minOccurs=0 maxOccurs=l) field contains the amount of time (in minutes) that it takes to 
return from the meeting location. These optional elements show in free/busy calculations. 
The ZgetCalendarDaysResponse/event/body/freeBusyStatus (string minOccurs=0 
5 maxOccurs=l) optional element annotates the freeBusy behavior of this event. Events by 
default appear as "busy* \ The user may exphcitly define this event to be annotated by setting 
.NET Calendar values to free, tentative, busy or away. 

The /getCalendarDaysResponse/event/body/cuid (string minOccurs=0 maxOccurs=l) 
cuid (CorrelationUID) links an organizer's event to an attendee's event. It identifies which 
□ 10 response from an attendee is for which request from an organizer, and which meeting request 
2^ update from the organizer is for which previously accepted meeting by the attendee. The 

i.Ti 

J "cuid" is the same on both the attendee's and the organizer's copy of the appointment. It is 
also identical on the exception and the recurring master. This value is assigned by the .NET 
i y Calendar server and is non-modifiable. 

3 1 5 The /getCalendarDaysResponse/event/body/organizer (minOccurs=0 maxOccurs= 1 ) 

field contains the email address of the event organizer. 

The /getCalendarDaysResponse/event/body/organizer/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
/getCalendarDaysResponse/event^ody/organizer/name/@xml:lang(minOcciirs===l 
20 maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 
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/getCalendarDaysResponse/event/body/organizer/name/@dir (string minOccurs=0 
maxOcciirs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/body/organizer/puid (string minOccurs=0 
5 maxOccurs=l) optional element specifies the PUID for the enclosing element. The 

/getCalendarDaysResponse/event/body/organizer/email (string minOccurs=0 maxOccurs=l) 
optional name specifies an e-mail address for the enclosing element. 

The /getCalendarDaysResponse/event/body/{any} (minOccurs=0 
maxOccurs=unbounded) provides for additional body elements. 
Q 10 The ZgetCalendarDaysResponse/event/attendeeEventExtra (minOccurs=0 

'J maxOccurs=l) field contains additional information about an event, found only in an event 

i. S S 

::S invitee's schema. The 

/getCalendarDaysResponse/event/attendeeEventExtra/@changeNumber (minOccurs=l 

□ 

f y maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 

•' s r. 

15 descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/intendedFreeBusy (string 
minOccurs==0 maxOccurs=l) element is the event organizer's freeBusy information and is 
thus equal to event/freeBusyStatus. Invitees may overwrite event/freeBusyStatus with a new 
20 value, and intendedFreeBusy is intended to store the organizer's original freeBusyStatus. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/responseTime (dateTime 
minOccurs=0 maxOcciirs=l) field contains the reply time on each attendee is set to the current 
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time (Now) when the organizer sends a meeting invitation. When the attendee responds, they 
update their responseTime. When the organizer receives responses, they will honor only those 
that have a higher responseTime than what is maintained in his/her own copy of the event for 
each attendee. While processing the response, the organizer will update their responseTime. 
This guarantees that the organizer honors only the most recent response from the attendee. 
This is stored in UTC. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/responseType (string 
minOccurs=0 maxOccurs=l) accept status indicates the valid types of responses that an 
attendee can reply with {accept, decline, tentative, counterpropose}. The absence of this field 
indicates that no response has been recorded (either the invitation has not been sent, or that a 
reply has not been received). 

The/getCalendarDaysResponse/event/attendeeEventExtra/counterProposeStartTime 
(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal start time 
infonnation. If responseType=[counterPropose], then either the {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new start time for 
the meeting. This is stored in UTC. 

The/getCalendarDaysResponse/event/attendeeEventExtra/counterProposeEndTime 
(dateTime minOccurs=0 maxOccurs=l) field contains the counter proposal end time 
information. If responseType=[counterPropose], then either the {startTime, endTime}, or 
location, or both can be present. This is the invitee's counterproposal for a new end time for 
the meeting. This is stored in UTC. 
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The/getCalendarDaysResponse/event/attendeeEventExtra/counterPropose^^ 
(string minOcciirs=0 maxOccurs=l) field contains the counter proposal location information, 
field contains the counter proposal start time information. If responseType=[counterPropose], 
then either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 

The ZgetCalendarDaysResponse/event/attendeeEventExtra/responseBody (string 
minOccurs=0 maxOccurs=l) field contains an optional message for invitees to include along 
with the response. The 

/getCalendarDaysResponse/event/attendeeEventExtra/responseBody/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
/getCalendarDaysResponse/event/attendeeEventExtra/responseBody/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of directionally 
neutral text. Possible values include rtl (right to left) and Itr (left to right). 

The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder 
(minOccurs=0 maxOccurs=l) field stores information of a delegate who responds on behalf of 
an invitee. The 

/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The 

/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name/@xmh 
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(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/puid 
(shring minOccurs=0 maxOccurs=l) optional element specifies the PUID for the enclosing 
element. The/getCalendarDaysResponse/event/attendeeEventExtra/delegateResponder/email 
(string minOccurs=0 maxOccurs=l) optional name specifies an e-mail address for the 
enclosing element. The /getCalendarDaysResponse/event/attendeeEventExtra/{any} 
(minOccurs=0 maxOccurs=unbounded) provides for additional attendee extra properties. 

The /getCalendarDaysResponse/event/attachment (minOccurs=0 
maxOccurs==unbounded) element contains attachment metadata, name, content-type and id's, 
and may also contain the attachmentBody. The 

/getCalendarDaysResponse/event/attachment/@changeNumba- (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facihtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /getCalendarDaysResponse/event/attachment/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Nonnally, 
.NET My Services generates and assigns this ID during an insertRequest operation, or 
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possibly during a replaceRequest. Application software can override this ID generation by 
q)ecifying the useClientlds attribute in the request message. After an ID has been assigned, 
the attribute is read only and attempts to write it are silently ignored. 

The /getCalendarDaysResponse/event/attachment/@creator (minOccurs=l 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 
node. The /getCalendarDaysResponse/event/attachment/name (string minOccurs=l 
maxOccurs=l) element contains information about an individual attachment in a mail 
message. The /getCalendarDaysResponse/event/attachment/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type ofthe content within this element The 

/getCalendarDaysResponse/event/attachment/name/@dir (string minOccurs==0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. VaUd values 
are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/attachment/contentType (string minOccurs=l 
maxOccurs=l) element contains the content type ofthe attachment. The 
/getCalendarDaysResponse/event/attachment/contentTransferEncoding (string minOccurs=l 
maxOccurs=l) element contains the encoding of the attachment. This information is 
necessary for decoding the attachment. The /getCalendarDaysResponse/event/attachment/size 
(unsignedLong minOccurs=l maxOccurs=l) element contains the size ofthe attachment in 
bytes. The /getCalendarDaysResponse/event/attachment/attachmentBody (base64Binary 
minOccurs=l maxOccurs=l) element contains the contents of the attachment. 
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The /getCalendarDaysResponse/event/reminder (minOccurs=0 maxOccurs=l) is 
directed to reminders. A user may optionally define a reminder for this appointment. 
Reminders for recurring appointments will be sent periodically before the appointment, as per 
the rules defined in the reminder subschema below. A non-recurring event may define no 
5 reminders, define a reminder with <set> = "true" or define a reminder with <set> = "false". 

A recurring meeting may have no reminders defined, or a recurring reminder defined 
with all instances receiving reminders. To define no reminders by default, but to define 
reminders for particular meeting instances in the exception body, a reminder <set> = "false" is 
: 5^ created, and tumed on and/or modified for particular instances. To define a recurring 

;! 85!; 

i;3 10 reminder, but tum it off for particular meeting instances, a reminder <set> = "true" is created, 
J and tumed off for particular instances. 

If the event's reminder subschema is non-existent, yet the exception body has a 

y 

reminder blob, then the exception reminder is ignored. An alternative is to require this. 

I y The /getCalendarDaysResponse/event/reminder/@changeNumber (minOccurs=l 

fU. 

Q 15 maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /getCalendarDaysResponse/event/reminder/@id (minOccurs=l maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services, Normally, 
20 .NET My Services generates and assigns this ID during an insertRequest operation or possibly 
during a replaceRequest. Application software can override this ID generation by specifying 
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the useClientlds attribute in the request message. After an ID has been assigned, the attribute 
is read only and attempts to write it are silently ignored. 

The /getCalendarDaysResponse/event/reminder/@creator (minOccurs=l 
maxOcciirs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 
node. The /getCalendarDaysResponse/event/reminder/set (boolean minOccurs=l 
maxOccurs=l) field maintains a Boolean flag that indicates whether the reminder is active for 
this event. In most cases, this will be true, but in the case of a recurring appointment, this flag 
may default to true with specific instances not to be reminded, or default to false, with specific 
instances to be reminded. 

The /getCalendarDaysResponse/event/reminder/to (string minOccurs=l 
maxOccurs=l) stores a friendly name that this reminder is being sent to. The 
/getCalendarDaysResponse/event/reminder/to/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /getCalendarDaysResponse/event/reminder/to/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
locaUzed string. Valid values are rtl (right to left) and Itr (left to right). 



The /getCalendarDaysResponse/event/reminder/offset (int minOccurs=l 
maxOccurs=l) field specifies the offset, in minutes, of how long before the event the user 
should be reminded. Recommended values are set forth in the following table: 



Value 


Description 


5, 10, 20, 30, 45 


5, 10, 20, 30, 45 minutes before the event | 


60, 120, 180, 


1,2, 3 hours before the event { 
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startTime - startDay 


The day of the event (reminder sent at 12:00am) 


startTime - (startDay - (1440 * x)) 


"x" days before the event (reminder sent at 12:00am 
"x" days before) 



The /getCalendarDaysResponse/event/reminder/interruptability (int minOccurs=0 
maxOccurs=l) optional element defines how intermptible this event is and it is used by 
notification routing software to make decisions about the relay and deferral of notifications 
5 that might occur while this meeting is active. The value contained in this element is a 
numeric value between one and ten. Low values represent a high cost of disruption, high 
values represent a low cost of disruption. 
Q The /getCalendarDaysResponse/event/reminder/lastSentTime (dateTime minOccurs=l 

maxOccurs=l) field is required by the reminder engine. The 

ifi 

lig 10 /getCalendarDaysResponse/event/reminder/nextTriggerTime (dateTime minOccurs=l 
maxOccurs=l) determines the next time to trigger reminder. 

;; The /getCalendarDaysResponse/ event/attendee (minOccurs=0 

i y 

maxOccurs=imboimded) includes the attendeeType, which contains the information about an 
attendee, including the display, email, puid, and the attendee's response. 

1 5 The /getCalendarDaysResponse/event/attendee/name (string minOccurs=0 

maxOccurs=l) optional element specifies the name for the enclosing element. The 
/getCalendarDaysResponse/event/attendee/name/@xml:lang (minOccm's=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 

20 within this element. The /getCalendarDaysResponse/event/attendee/name/@dir (string 
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minOccurs=0 niaxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/attendee/puid (string minOccurs=0 
maxOccurs==l) optional element specifies the PUID for the enclosing element. The 
/getCalendarDaysResponse/event/attendee/email (string niinOccurs=0 maxOccurs=l) optional 
name specifies an e-mail address for the enclosing element. The 

/getCalendarDaysResponse/event/attendee/inviteType (string minOccurs=l maxOccurs=l) is 
used by a meeting organizer to define the kind of invitee, e.g., as required, optional, or a 
resource (e.g., meeting room). 

The /getCalendarDaysResponse/event/attendee/responseTime (dateTime minOccurs=0 
maxOccurs=l) reply time on each attendee is set to the current time (Now) when the organizer 
sends a meeting invitation. When the attendee responds, they update their responseTime. 
When the organizer receives responses, they will honor only those that have a higher 
responseTime than what s/he maintains in his/her own copy of the event for each attendee. 
While processing the response, the organizer will update their responseTime. This guarantees 
that the organizer honors only the most recent response firom the attendee. This is stored in 
UTC. 

The /getCalendarDaysResponse/event/attendee/counterProposeStartTune (dateTime 
minOccurs=0 maxOccurs=l) field contains the counter proposal start time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. 
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The/getCalendarDaysResponse/event/attendee/counterProposeEndTime(dateTime 
mmOccurs=0 maxOccurs=l) field contains the counter proposal end time information. If 
responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 

can be present. This is the invitee's counterproposal for a new end time for the meeting. This 
is stored in UTC. 

The ZgetCalendarDaysResponse/event/attendee/counterProposeLocation (string 
minOccurs=0 maxOccurs=l) field contains the counterproposal location information, field 
contains the counterproposal start time information. If responseType=[counterPropose], then 
either the {startTime, endTime}, or location, or both can be present. This is the invitee's 
counterproposal for a location for the meeting. 

The /getCalendarDaysResponse/event/attendee/responseBody (string miDOccurs=0 
maxOccurs=l) field contains an optional message for invitees to include along with the 
response. The/getCalendarDaysResponse/event/attendee/responseBody/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this elemait. The 

/getCalendarDaysResponse/event/attendee/responseBody/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the base direction of directionally neutral text. 
Possible values include rtl (right to left) and Itr (left to right). 

The /getCalendarDaysResponse/event/attendee/{any} (minOccurs=0 
maxOccurs=unbounded) allows for extensibility. 
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The/getCalendarDaysResponse/event/recurrence/rule (minOccurs==l maxOccurs=l) 
includes /getCalendarDaysResponse/event/recurrence/rule/creationDate (dateTime 
minOccurs=l maxOccurs==l), which is required to determine which timezone recurrence rale 
to use. The startTime of the event is not used because of the ability to create events in the past 
and in the future. 

The /getCalendarDaysResponse/event/recurrence/rale/firstDayOfWeek (string 
rainOccurs=l maxOccurs=l) stores what the first day of the week is for this user. Typical 
values are (su) Sunday or (mo) Monday. This is used for calculating the recurrence 
expansion, and allows recurring meetings to be expanded in the organizer's FirstDOW instead 
of the invitee's FirstDOW. 

The /getCalendarDaysResponse/event/recurrence/rale/tzid (int minOccurs=0 
maxOccurs=l) field identifies the time zone for this recurring event. All dateTime 
information in this event is stored in UTC (converted from the local time zone defined by the 
time zone sub-schema). If this field is absent, the recurring event is assumed to be recurring in 
UTC time. However, it is only a floating recurring event if the <floating> attribute is set: 
<timeZone floating="...'' 

id 

=".,."> 

<standardBias> 

</standardBias> 

<additionalDaylightfiias> 

0..1 

</additionalDaylightBias> 
<standardDate> 
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0..1 

<transitionRule weekdayOfMonth="..." day="..." dayOfMonth="..." month="..." 
afterDay="..;'> 

</transitionRule> 

<transitionTime> 

</transitionTime> 

</standardDate> 
<daylightDate> 

<transitionRule weekdayOflVLonth-"..." day=",.." dayOfMonth="..." month^"..," 
afterDay="..."> 

</transitionRule> 

<transitionTime> 

</transitionTime> 

</daylightDate> 

</timeZone> 

^ The /getCalendarDaysResponse/event/recurrence/rule/isLeapYear (boolean 

i H minOcciirs=0 maxOccurs=l) provides International calendar support. It is possible to derive 
Q isLeapYear from leapMonthValue, but .NET Calendar stores both separately. The 
5 /getCalendarDaysResponse/event/recurrence/rule/leapMonthValue (int minOccurs=0 

maxOccurs=l) <leapMonthValue> cannot be derived from a particular year and thus must be 
stored. For example, a user creates a recurrence on a Hebrew Lunar calendar. The year is a 
leap year and it has 13 months. In that year, the leapMonthValue is 7. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat (minOccurs=l 
1 0 maxOccurs=l) may includes the 

/getCalendarDaysResponse/event/recurrence/rule/repeat/daily (minOccurs=0 maxOccurs=l), 
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field, which specifies the number of days to repeat, e.g., repeat every days. The 

/getCdendarDaysResponse/event/recun-ence/nde/repeat/daily/@da 

miiiOccurs=l maxOccurs=l) specifies the periodicity of days over which repetition occurs, 

for example, repeat every 3 days. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat/weekly (minOccurs=0 
maxOccurs=l) field, if present, is directed to repeating weekly, e.g., repeat every [...] week(s) 
on {su,mo,tu,we,th,fr,sa} . The presence of a weekday attribute means to repeat on this 
particular day. Any combination of the seven days is valid. 

The/getCalendarDaysResponse/event/recurrence/rule/repeat/weekly/@week^^ 
(int minOccurs=0 maxOccurs=l) repeat Weekly recurrence occurs every period of weeks. If 
the attribute is not present, it defaults to 1 (every week). 

The/getCalendarDaysResponse/event/recurrence/rule/repeat/monthlyByDay 
(minOccurs=0 maxOccurs=l) specifies to repeat on the [First, Second, Third, Fourth, Last] 
{su, mo, tu, we, th, fr, sa} of every [...] month(s). Any combination of the {weekday} 
attributes are valid, including user-defined combinations for weekdays and weekend days. 

The 

/getCalendarDaysResponse/event/recurrence/rule/repeat/monthlyByDay/@monthFrequency 
(int minOccurs=0 maxOccurs=l) specifies the month periodicity to recur on. If this attribute 
is not present, it defaults to 1 (every month). 
The 

/getCalendarDaysResponse/event/recurrence/rule/repeat/monthlyByDay/@we 
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(string minOccurs=l maxOccurs-1) specifies which week in a month [first, second, third, 
fourth, last]. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat/monthly (minOccurs=0 
maxOcciirs=l) repeats the occurrence every month on a particular day. The very first 
5 occurrence is created firom the parent event's startTime and endTime, but the recurrence 
occurs as follows: Repeat every month on [day] of [month]. Repeat every [monthFrequency] 
month(s) on [day] of [month]. Typically, the first occurrence is also an instance of the 
recurrence, but this need not be the case. 
The 

3 10 /getCalendarDaysResponse/event/recurrence/rule/repeat/n^ 

a minOccurs=0 maxOccurs=l) optional attribute indicates the month periodicity. By default, it 
'§ is 1, periodic every month. The start of the periodicity is determined fi-om event startTime. 
[j^ The /getCalendarDaysResponse/event/recurrence/rale/repeat/monthly/@day (int minOccurs=l 
y maxOccurs=l) specifies the day of the month to recur on. Vahie is between one and 3 1 . 
315 A forceExact rule handles invalid day-month combinations. The proper recurrence 

pattem for repeating on the last day of the month is to use repeatMonthlyByDay. "Repeat on 
the [last] [day, weekday, weekend day] of By default, an invaUd day-month combination 
will cause .NET Calendar to search backwards to find a vaUd day-month combination. If 
/getCalendarDaysResponse/event/recurrence/rale/repeat/monthly/@forceExact (boolean 
20 minOccurs==0 maxOccurs=l) is true, an invalid starting [month ,day] combination such as [6, 
31] is ignored and will not be included as an instance of the recurrence. With forceExact, 
day=3 1 will only pick up months that have 3 1 days, day-30 will pick up all months except 
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Febraary, day=29 will pick up all months except February, except on leap years. February 29 
is included on leap years. 

The / getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay 
(minOccurs=0 maxOccurs=l) specifies how to repeat on the [First, Second, Third, Fourth, 
5 Last] {su, mo, tu, we, th, fr, sa} of [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, 
Dec] every [yearFrequency] years. 

Any combination of the {weekday} attributes are valid, including user-defined 
combinations denoting weekdays and weekend days. This element's attributes contain 
whether a given day is or is not considered by the user as part of the work week. If this 
Q 10 element has no attributes, it is assumed that the user has a Monday to Friday work week, 
'4 The 

|: 1; / getCalendarDaysRespome/eventyrecurrence/rule/repeat/yearlyByDay/@yearFrequen^ (int 

minOccurs=0 m^Occurs=l) optional attribute indicates the year periodicity. By default, it is 
I y 1 (repeat every year). 

i;il5 The 

/getCalendarDaysResponse/event/recuiTence/rule/repeat/yearlyByDay/@weekdayO 
(string minOccurs=l maxOccurs=l) Specifies which week in a month [first, second, third, 
fourth, last] to repeat. 

The/getCalendarDaysResponse/event/recurrence/rule/repeat/yearlyByDay/@mon^ 
20 (int minOccurs=l maxOccurs=l) contains a value between one and thirteen (some calendars 
have thirteen months). 



-160- 



The /getCalendarDaysResponse/event/recurrence/rule/repeat/yearly (minOccurs=0 
maxOccxirs=l) specifies to repeat every year on a particular date. The very first occurrence is 
created from the parent event's startTime and endTime, but the recurrence occurs as follows: 
Repeat yearly on [day] of [month]. Repeat every [yearFrequency] years on [day] of [month]. 
Typically, the first occurrence is also an instance of the recurrence, but this need not be the 
case. 

The / getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@yearFrequency 
(int minOccurs=0 maxOccurs=l) optional attribute indicates the year periodicity. By default, 
it is 1 (repeat every year). The 

/getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@month(intminOccurs=l 
maxOccurs=l) specifies the month to recur on. 

The /getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@day (int 
minOccurs=l maxOccurs=l) specifies the day of the month to recur on. The value is between 
1-31, and forceExact, appUes for invalid day-month combinations. Thus, by default, an 
invalid day-month-year combination will cause .NET Calendar to search backwards to find a 
valid day for a particular month, year. If 

/getCalendarDaysResponse/event/recurrence/rule/repeat/yearly/@forceExact (boolean 
minOccurs=0 maxOccurs=l) is true, an invahd starting [month ,day] combination such as [6, 
31] is ignored and will not be included as an instance of the recurrence. With forceExact, 
.NET Calendar, day=31 will only pick up months that have 31 days, day=30 will pick up all 
months except February, day=29 will pick up all months except February, except on leap 
years. February 29 is included on leap years. 
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The /getCalendarDaysResponse/event/reciirrence/rule/repeat/{any} (minOccurs==0 
maxOcciirs=unboiinded) allows for any additional repeat rules. 

The /getCalendarDaysResponse/event/recurrence/rule/windowEnd (dateTime 
minOccurs=0 maxOccurs=l) field indicates the end of the window over which the recurrence 
5 occurs. This is stored in UTC. The Maximum range is January 1, 1753 to December 31, 
9999 to an accuracy of 3.33 milliseconds. Note that windowEnd, repeatForever, 
repeatListances maybe selectable. 

The /getCalendarDaysResponse/event/recurrence/rule/repeatForever (boolean 
, ^ minOccurs=0 maxOccurs==l) overrides the windowEnd date and specifies that this recurrence 
□ 10 repeats forever. CUent implementations cannot depend on date vahies repeating forever, like 

I: 

'^J 23:59:59pm Dec 31, 9999 or 23:59 Aug 31, 4500. 

!:S The /getCalendarDaysResponse/event/recurrence/rule/repeatlnstances (int 

i^^, minOccurs=0 maxOccurs=l) overrides the windowEnd date and specifies that this recurrence 

so. 

fU repeats for the specified number of instances. As is apparent, repeatlhstances and 

15 repeatForever are mutually exclusive, but repeatlnstances will override repeatForever for 
errant schemas. 

Note that if the method causes a failure response to be generated, the failure is noted 
by generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "s:mustUnderstand*', a .NET My Services standard error, security violation, load- 
20 balance redirect, or any service-specific severe error condition. 

The myCalendar/getFreeBusyDays Method is accessed using a request message, and in 
response may generate a response message or a SOAP Fault message. The following sample 
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document outlines and descriptions below illustrate the structure and meaning of the elements 
and attributes in the request and response messages: 

<m:getFreeBusyDaysRequest 

xmlns:m="http://schemas.microsoflxom/hs/2001/10/myCalendar" 

xmhis:hs="http://schemas.microsofl.com/hs/2001/10/core">i..i 

<m:calendarType>o..i</m:calendarType> 

<m: startTime>i i </m: startTime> 

<m:endTime>i ..i</m:endTime> 

<m:getFreeBlocks>o..i</m:getFreeBlocks> 

<m:returnMdividualBlocks>o..i<m:returnIndividualBlocks> 
</m:getFreeBusyDaysRequest> 

The ZgetFreeBusyDaysRequest (minOccurs=l maxOccurs=l) function retums a stream 
of xml fragments defining the user's freeBusy information between two dates. Single events 
and recurring events within the time window are translated into blocks of free/busy time. 
The getFreeBusyDays only retums the blocks and their associated type. There is no explicit 
method to return unmerged freeBusy info, as that kind of behavior is fully contained within 
getCalendarDays. 

This method follows the precedence order: Away(OOF), Busy, Tentative, Free. 
Overlapping blocks of the same freeOrBusyStatus kind are coalesced to form larger blocks. 
Overlappmg blocks of different freeOrBusyStatus are overlaid. The events with higher 
precedence overlay on top (not by starting time). For example, Busy from 8 to 9, Tentative 
from 8:30 to 10, OOF from 9:30 to 1 1, Free from 10:30 to 12, is merged as Busy from 8 to 9, 
Tentative from 9 to 9:30, OOF from 9:30 to 1 1, Free from 1 1 to 12. 
The freeBusy information of multiple users is retrieved by specifying a puid for each user in 
question. The caller of this function needs to specify their own puid, no impUcit assumptions 
are made, 
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The calling method takes a startDate and an endDate to define the duration over which 
freebusy information is retumed. A third parameter determines if free blocks are explicitly 
retumed. Free blocks are intervals where no calendar object exists. 

The getFreeBusyDays method may be used to retrieve multiple calendar data from other users 
using <h:key instance="0" cluster="0" puid="xyz"/> in the SOAP headers provided that puid 
^'xyz" is provisioned on the .NET Calendar server, and provided that the user has been graated 
access in puid "xyz"'s rolelist. 

The ZgetFreeBusyDaysRequest/calendarType (string minOccurs=0 maxOccurs=l) 
contains the optional calendar type to retum, with the default being Gregorian. The 

/getFreeBusyDaysRequest/startTime (dateTime minOccurs=l maxOccurs=l) field 
contains the starting time window of calendar objects to retrieve. This dateTime also contains 
the timeZone to retrieve the calendar information in. 

The ZgetFreeBusyDaysRequest/endTime (dateTime muiOccurs=l maxOccurs=l) field 
contains the ending time window to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in, and needs to be the same timeZone as 
startTime. 

The ZgetFreeBusyDaysRequest/getFreeBlocks (boolean minOccurs=0 maxOccurs=l) 
boolean causes .NET Calendar to explicitly retum free time as freeBusy blocks. By default, 
free blocks are not retumed. The ZgetFreeBusyDaysRequest/retumlndividualBlocks (boolean 
minOccurs=0 maxOccurs=l) boolean causes .NET Calendar not to coalesce/merge freeBusy 
information. By default, freeBusy information is merged. 
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Upon successful completion of the getFreeBusyDays method, a 

myCalendar/getFreeBusyDaysResponse response message is generated. The format of the 

response message is described below: 

<m:getFreeBusyDaysResponse selectedNodeCount=".,." status-'.,/' 
xmlns :m="http ://schemas.microsoft.com/hs/200 1/1 0/myCalendar" 
xmlns:hs="http://schemas.niicrosoftxoni/hs/2001/10/core">i.,i 

<m:freeOrBusyEvent>o.,unbounded 

<m:startTime>i..i</m:startTime> 

<m: endTime>i i</m:endTime> 

<m: type>i 1 </m:type> 
</m:freeOrBusyEvent> 
</m:getFreeBusyDaysResponse> 

The ZgetFreeBusyDaysResponse (minOccurs=l maxOccurs=l) response XML blob 
format, comprises freebusy xml fragments. The 

/getFreeBusyDaysResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute 
is used to return the number of selected nodes, selected by the corresponding data language 
operation. 

The /getFreeBusyDaysResponse/@status (string minOccurs==l maxOccurs=l) attribute 
indicates the status of the method, e.g., success when the corresponding method was 
completed successfully, failure when the corresponding method was not completed 
successfully, rollback when the method failed, but was rolled back to its pre-updateBlock 
status, or notAttempted when the corresponding method was not attempted. This occurs when 
a previous operation failed. 

The ZgetFreeBusyDaysResponse/freeOrBusyEvent (minOccurs=0 
maxOccurs=unbounded) includes /getFreeBusyDaysResponse/freeOrBusyEvent/startTime 
(dateTime minOccurs=l maxOccurs=l) which specifies the start time, 
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/getFreeBusyDaysResponse/freeOrBusyEvent/endTime (dateTime minOccurs=l 
maxOccurs==l) which specifies the end time, and 

ZgetFreeBusyDaysResponse/freeOrBusyEvent/type (string minOccurs=l maxOccurs=l) which 
specifies the type, including fi-ee, tentative, busy or away. 

The myCalendar/getQuickView Method provides a QuickView/DatePicker service 
function. The following table and description below describes the request message for this 
method: 

<m:getQuickViewRequest 

xmlns:m="http://schemas,microsoft.com/hs/2001/10/myCalendar" 

xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:calendarType>o..i</m:calendarType> 

<m:startTime>i .,i</m:startTime> 

<m:endTime>i ..i</m:endTime> 

<m:tzid>o..i</m:tzid> 

<m:biasOffset>o.. i</m:biasO£fset> 
</m:getQuickViewRequest> 

The /getQuickViewRequest (minOccurs=l maxOccurs=l) function provides an 
efficient, hghtweight means to query a date range to indicate days that have 1 or more 
appointments (1) and days without appointments (0), Outlook® and OWA® (Outlook® Web 
Access) use this for their datepicker functionality. The date range takes timeZone-specific 
start and end times, using just the year, month, and day. The time zone can be a simple bias, 
since this is merely a request for data. startTime and endTime are required to have the same 
time-zone bias, hi effect, the method "overlays" the incoming time zone onto the user's 
calendar to define the dayblocks for which the QuickView returns data. 

The /getQuickViewRequest/calendarType (string minOccurs=0 maxOccurs=l) 
provides a field for the Optional calendar type to return, with the default being Gregorian. 
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The /getQuickViewRequest/startTime (dateTime minOcciirs=l maxOccurs=l) field contains 
the starting time window of calendar objects to retrieve. This dateTime also contains the 
timeZone to retrieve the calendar information in. 

The /getQuickViewRequest/endTime (dateTime minOcciirs=l maxOccurs=l) 
specifies the ending time vraidow to retrieve calendar objects. This dateTime also contains the 
timeZone to retrieve the calendar information in. It must be the same timeZone as startTime. 

The /getQuickViewRequest/tzid (int minOccurs=0 maxOccurs=l) field optionally 
specifies a timezone to retrieve the quickView in. If this or biasOffset are both missing, 
TZ_UTC is assumed. The /getQuickViewRequest/biasOfifeet (int minOccurs=0 
maxOccurs=l) field optionally specifies a numeric integer offset timezone bias to retrieve the 
quickView in. tzid takes precedence over biasOfFset (pending xsd:choice). 

Upon successfiil completion of the myCalendar/getCJuickViewmethod, a 
myCalendar/getQuickViewResponse response message is generated. The format of the 
response message is described in the table and description below: 

<m:getQuickViewResponse selectedNodeCount="..." status- 

xmkis:m="http://schemas.microsoft.com/hs/2001/10/myCalendar" 

xmhis:hs="http://schenias.microsoft.com/hs/2001/10/core">i..i 

<m:month m="..." year="...">i..u„hounded 
<m:day d- '...">i..3i<;/m:day> 

<ym:month> 
<ym:getQuickViewResponse> 

The /getQuickViewResponse (minOccurs=l maxOccurs=l) return value of 
getQuickView is a list of calendar days grouped into months. The 
/getQuickViewResponsa'@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute is 
used to return the number of selected nodes, selected by the corresponding data language 
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operation. The /getQuickViewResponse/@status (string minOccurs=l maxOccurs=l) 
attribute indicates the status of the method, e.g., success when the corresponding method was 
completed successfully, failure when the corresponding method was not completed 
successfully, rollback when the method failed, but was rolled back to its pre-updateBlock 
status, or notAttempted when the corresponding method was not attempted. This occurs when 
a previous operation failed. 

The /getQuickViewResponse/month (minOccurs=l maxOccurs=unbounded) 
field specifies the month block for the grouping of calendar days. The 
/gelQuickViewResponse/month/@m (int minOccurs=0 maxOccurs=l) provide a month 
number, restrict to between one and thirteen, (as some calendars have thirteen months). 

The /getQuickViewResponse/month/@year (int minOccurs=0 maxOccurs=l), 
provides the year, while the 

/getQuickViewResponse/month/day (boolean minOccurs=l maxOccurs=31) field 
specifies whether this day is fi-ee (0) or has at least one event on it or overlapping (1). The 
/getQuickViewResponse/month/day/@d (int minOccurs=0 maxOccurs=l) field specifies a 
day in this month. 

The myCalendar/sendMeeting method is directed to the organizer meeting request, is 

accessed using a request message, and in response may generate a response message or a 

SOAP Fault message. The following sample document fragments illustrate the structure and 

meaning of the elements and attributes in the request and response messages. The following 

table and description below describes the request message for this method: 

<m:sendMeetingRequest eventid-'..." criticalChange-'..." recurrenceld="..." 
continueOnFailure- deleteOnCompletion-'..." 
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xmlns:m="http://schemas.microsoft.com/hs/2001/10/myCalendar" 
xmlns:hs-'http://schemas.microsoftxom/hs/2001/10/core''>i..i 
<m:umnvite behavior="...">i..i 
<m:attendee deleteAttendee^"...' -^0.. unbounded 
<hs:name xml:lang="..." dir="..,">o..i</hs:name> 
<hs:puid>o,i</hs:puid> 
<hs:email>o..i</hs:email> 
</m:attendee> 
</m:uninvite> 

<m:replaceRequest select=".. " useClientIds="..." minOccurs="..," maxOccurs^".. ">o..i 
<hs:options>o..i {any}</hs:options> 
<hs:attributes {any}="...">o..unbounded</hs:attributes> 
{any} 

</m:replaceRequest> 
<m:invite behavior="...">i..i 

<m:attendee>o. .unbounded 

<hs:name xml:lang="..." dir="...">o..i</hs:name> 

<hs:puid>o,.i</hs:puid> 

<hs:email>o..i</hs:email> 
</m:attendee> 
</m:invite> 

</m:sendMeetingRequest> ^ 

The purpose of this method is for a meeting organizer to invite and uninvite (cancel) 
attendees to this event. The /sendMeetingRequest (ininOccurs=l maxOccurs=l) sendMeeting 
also sends updated invitations to existing invitees. Inviting a user to a single instance of a 
recurring event will cause only that instance to be sent. However, future updates to that event 
will overwrite the existing instance, including the case where an update is the full recurring 
event. Meeting requests will be sent out as attachments from an SMTP server. 
When inviting or uninviting, .NET Calendar searches for these existing attendees by puid first, 
and then by email address such that the puid receives precedence in the search predication. 
.NET Calendar will not allow multiple meeting requests/cancellations to the same puid or 
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email address within the scope of the same invite or iminvite block. However, an organizer 
may uninvite an attendee and then reinvite again (non-standard behavior). 

The /sendMeetingRequest/@eventId (string minOcciirs=l maxOccurs=l) field 
contains the puid of the event which to send meeting invitations or cancellations to. This 
5 event must akeady exist within the .NET Calendar service. Additional server constraints are 
implemented which verify that potential updates to the attendee tables occur for this event 
only. This is a required field. 

The /sendMeetingRequest/@criticalChange (boolean minOccurs=0 maxOccurs=l) 
attribute, when set to 'true", causes <lastUpdateTime> to be updated when invitations are sent 
Q 10 to the attendees. If"fialse'\<lastUpdateTime> remains untouched. 
'J The /sendMeetingRequest/@recurrenceId (dateTime minOccurs=0 maxOccurs=l) 

V^: optional recurrenceld allows the meeting organizer to send invitations for only a particular 

instance of a recurring event. If the event is not a recurring event, or if recurrenceld does not 

i y correspond to a valid instance/exception, sendMeetingRequest will fail with an error. 

i y 

15 The /sendMeetingRequest/@continueOnFailure (boolean minOccurs=l maxOccurs=l) 

Us 

field specifies to .NET Calendar to continue performing the sendMeetingRequest even on a 
failure. Points of failure: <uninvite> may delete attendees, and the data language delete may 
encounter errors <updateRequest> may encounter data language errors. The optional final 
delete of the event may encounter errors. 
20 The /sendMeetingRequest/@deleteOnCompletion (boolean minOccurs=0 

maxOccurs=l) event will be deleted upon completion of this sendMeetingRequest. This 
behavior is intended for deleting a meeting and sending cancellations. If recurrenceld is 
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present (and valid), only this particular recurring instance or exception is deleted, in which 
case a new <deletedExceptionDate> is added to the recurrence rule. 

The /sendMeetingRequest/uninvite (minOccurs=l maxOccurs==l) includes The 
/sendMeetingRequest/uninvite/@behavior (string minOccurs=0 maxOccurs=l), an attribute 
that gives the option to either choose to send cancellations to "all" attendees in the event's 
attendee table, or send to "none" of them. A third value of "default" would give the default 
behavior of sending cancellations to all attendees who are replaced in the <rq)laceRequest> 
block. When this attribute is set, .NET Calendar will ignore anything within the <uninvite> 
node. 

The /sendMeetingRequest/uninvite/attendee (minOccurs=0 maxOccurs=unbounded) 
field contains a list of people to uninvite. Uninvited attendees must aheady exist in the 
organizer's attendee table, or else these users are ignored. 

The /sendMeetingRequest/uninvite/attendee/@deleteAttendee (boolean minOccurs=0 
maxOccurs=l) field optionally specifies whether or not to delete this attendee firom the 
organizer's attendee table. If the attendee is not deleted, .NET Calendar will not know the 
status of this attendee because the status {not-sent, sent, cancelled} is not stored per-attendee. 

The /sendMeetingRequest/uninvite/attendee/name (string minOccurs=0 maxOccurs=l) 
optional element specifies the name for the enclosing element. The 
/sendMeetingRequest/uninvite/attendee/name/@xml:lang (niinOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /sendMeetingRequest/uninvite/attendee/name/@dir (string 
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minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /sendMeetingRequest/uninvite/attendee/puid (string minOccurs=0 maxOccurs==l) 
optional element specifies the PUID for the enclosing element. The 
5 /sendMeetingRequest/uninvite/attendee/email (string minOccurs=0 maxOccurs=l) optional 
name specifies an e-mail address for the enclosing element. 

The /sendMeetingRequest/replaceRequest (minOccurs=0 maxOccurs=l) replace 
request can only affect the meeting invitation in question, and is thus constrained to be only 
i , @select="/m:myCalendar/m:event[@id==@eventId]/...". It will not be allowed to replace-on- 
r l 10 null so that event creation cannot be a side-effect. The 

%! /sendMeetingRequest/replaceRequest/@select (string minOccurs=l maxOcc\irs=l) attribute 
;;|[ selects an xdbrbhie or an xdb:red, 

I ^ The /sendMeetingRequest/replaceRequest/@useClientIds (string minOccurs==0 

ill maxOccurs=l) attribute specifies that, if an xdb:blue item is created during an insert or 
^3 15 replace operation, and an ID would normally be generated, the ID specified in the request 
content should be used instead of having .NET My Services generate an ID. Applications 
using this option must ensure that they are properly generating unique IDs in the form of 
UUIDs. They must also ensure that they do not assign the same ID to multiple xdb:blue 
items; this can happen if the insert select attribute selects multiple nodes. 
20 The /sendMeetingRequest/replaceRequest/@minOccurs (int minOccurs=0 

maxOccurs=l) optional attribute specifies the minimum number of nodes that must be 
selected by the select operation in order for this operation to be successfiiUy attempted. The 
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default value is zero, meaning that if no nodes are selected, the operation silently succeeds as 
a no operation C*NOP")- A value of one means that a minimum of one node must be selected. 
In that case, if no nodes are selected, the operation fails with an error. 

The /sendMeetingRequest/replaceRequest/@maxOccurs (int minOccurs=0 
5 maxOccurs=l) optional attribute specifies the maximum number of nodes that may be 

selected by the select operation in order for this operation to be successfully attempted. The 
default value is unbounded. If the number of nodes selected by the select attribute is greater 
than this value, an error condition occurs. The /sendMeetingRequest/replaceRequest/options 
; . (minOccurs=0 maxOccurs=l ) provide for options. 

□ 10 The/sendMeetingRequest/replaceRequest/options/{any} (minOccurs=0 

SI maxOccurs==unbounded) includes ^endMeetingRequest/replaceRequest/attributes 

(minOccurs=0 maxOccurs=nmbounded). This element is used to specify a single attribute to 

'".tseS 

be manipulated by the .NET My Services data-manipulation primitives. For example, when 
i y used in an insertRequest, this element specifies an attribute to be inserted at the specified 
Q 15 node. 

The /sendMeetingRequest/replaceRequest/attributes/@{any} (minOccurs=0 
maxOccurs=l) and /sendMeetingRequest/replaceRequest/{any} (minOccurs=0 
maxOccurs=unbounded) fields provide for extensibility. This element is a placeholder that 
indicates where the content of the item being replaced is to be specified. 
20 The /sendMeetingRequest/invite (minOccurs=l maxOccurs=l) includes the 

/sendMeetingRequesfyinvite/@behavior (string minOccurs=0 maxOccurs=l) attribute. This 
attribute will give the option to either choose to send invitations to "all" attendees in the 
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event's attendee table, or send to "none" of them. A third value of "default" would give the 
default behavior of sending invitations to only the new attendees in the <replaceRequest> 
block. When this attribute is set, .NET Calendar will ignore anything within the <invite> 
node. 

The /sendMeetingRequest/invite/attendee (minOccurs=0 maxOccurs=unbounded) 
field contains information about this attendee to be invited. An invited attendee must already 
exist in the organizer's attendee table. This attendee may originally be there prior to the 
sendMeetingRequest method, or be the result of the update operation to this meeting. To 
change the attendee's inviteType, the update operation should be used. 

When invitations are sent, the attendee's <responseTime> is set to the current time 
(now) as a side-effect. The /sendMeetingRequest/invite/attendee/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
/sendMeetingRequest/invite/attendee/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /sendMeetingRequest/invite/attendee/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /sendMeetingRequest/invite/attendee/puid (string minOccurs=0 maxOccurs=l) 
optional element specifies the PUID for the enclosing element. The 
/sendMeetin^equest/invite/attendee/email (string minOccurs=0 maxOccurs=l) optional 
name specifies an e-mail address for the enclosing element. 
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The myCalendar/respond method provides a method for invitees to respond to an 
invite. The following table and accompanying description below illustrate the structure and 
meaning of the elements and attributes in the request and response messages: 

xmhis:m="http://schemas.microsoft.com/hs/2001/10/myCalendaf' 

xmhis:hs-littp://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:responseTime>o..i</m:responseTime> 

<m:responseType>o,. i</m:responseType> 

<m:counterProposeStartTime>o..i</m:counterProposeStartTime> 

<m:counterProposeEndTime>o..i</m:counterProposeEndTime> 

<m:counterProposeLocation>o..i</m:counterProposeLocation> 

<m:responseBody xml:lang="..." diT="...">o..i</m:responseBody> 

<m:eventld>i..i</m:eventld> 

<m:puid>i..i</m:puid> 
</m:respondRequest> 



The purpose of this method is for a meeting invitee to respond to an invitation. 
Invitees may accept, decline, accept tentatively, or counterpropose in some means. Currently, 
allow the counterproposmg of time and location, but we may consider future additions. 
The /respondRequest (minOccurs=l maxOccurs=l) includes 
/respondRequest/responseTime (dateTime minOccurs=0 maxOccurs=l), field is the 
reply time on each attendee, set to the current time (Now) when the organizer sends a meeting 
invitation. When the attendee responds, they update their responseTime. When the organizer 
receives responses, they will honor only those that have a higher responseTime than what he 
or she maintains in his or her own copy of the event for each attendee. While processing the 
response, the organizer will update their responseTime. This guarantees that the organizer 
honors only the most recent response from the attendee. This is stored in UTC. 
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The /respondRequest/responseType (string minOccurs=0 maxOccurs=l) accept status 
indicates the valid types of responses that an attendee can reply with {accept, decline, 
tentative, counterpropose}. The absence of this field indicates that no response has been 
recorded (either the invitation has not been sent, or that a reply has not been received). 
5 The /respondRequest/counterProposeStartTime (dateTime minOccurs=0 

maxOccurs=l) field contains the counter proposal start time information. If 
responseType^[counterPropose], then either the startTime, endTime, or location, or all three 
can be present. This is the invitee's counterproposal for a new start time for the meeting. 
This is stored in UTC. 

;;3 10 The ZrespondRequest/counterProposeEndTime (dateTime minOccurs=0 

' maxOccurs=l) field contains the counter proposal end time information. If 

;;| responseType=[counterPropose], then either the {startTime, endTime}, or location, or both 

M. can be present. This is the invitee's counterproposal for a new end time for the meeting. This 

9 

! y is stored in UTC, 

! f 1 5 The ZrespondRequest/counterProposeLocation (string minOccurs=0 maxOccurs=l) 

field contains the counter proposal location information, field contains the counter proposal 
start time information. If responseType=[counterPropose], then either the {startTime, 
endTime}, or location, or both can be present. This is the invitee's counterproposal for a 
location for the meeting. 

20 The ZrespondRequest/responseBody (string minOccurs=0 maxOccurs=l) field contains 

an optional message for invitees to include along with the response. The 
/respondRequest/responseBody/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
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used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /respondRequest/responseBody/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the base direction of directionally neutral text. Possible values 
5 include rtl (right to left) and Itr (left to right). 

The /respondRequest/eventId (string niinOccurs=l maxOccurs=l) field contains the 
eventid for the meetmg, and the /respondRequest/pxiid (string minOccurs==l maxOccurs=l) 
field identifies the invitee. 
I The myCalendar/updateReminder Method provides a Delegate fimction to the .NET 

□ 10 Alerts service for creating or modifying calendar meeting reniinders. The following sample 
y document in the table and accompanying description below illustrate the structure and 
meaning of the elements and attributes in the request and response messages: 



<m:updateReminderRequest 
xmbis:m="http://schemas.microsoft.com/hs/2001/10/myCalendar*' 
xmhis:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:reminder>i .1 
<m:set>i..i</m:set> 

<m:to xml:lang="..." dir="...">i..i</m:to> 

<m:offset>i ..i</m:offset> 

<m:interruptability>o..i</m:interruptability> 

<m:lastSentTime>i .. i</m:lastSentTime> 

<m:nextTriggerTime>i..i</m:nextTriggerTime> 
</m:reminder> 
<m:id>i„i</m:id> 
</m:updateReminderRequest> 



The /updateReminderRequest (minOccurs=l maxOccurs=l) function is used to update 
15 the status of a reminder once the user has received the notification. It also may be exposed as 
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an HTTP API so that non-.NET My Services clients have a means to dismiss, snooze, or be 
reminded again at a different time. The /updateReminderRequest/reminder (minOccurs=l 
maxOccurs=l) includes the /updateReminderRequest/reminder/set (boolean minOccurs=l 
maxOcciirs=l) Boolean flag that mdicates whether the reminder is active for this event. In 
5 most cases, this will be true, but in the case of a recurring appointment, this flag may default 
to true with specific instances not to be reminded, or default to false, with specific instances to 
be reminded. 

The /updateReminderRequest/reminder/to (string minOccurs=l maxOccurs=l) field 
contains the fiiendly name that this reminder is being sent to. The 
p 10 AipdateReminderRequest/reminderyto/@xml:lang (minOccurs=l maxOccurs=l) required 
%J attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

Jill 

i;! described in RFC 1766. The value of this attribute indicates the language type of the content 

•txtr 

within this element. The /updateReminderRequest/reminder/to/@dir (string minOccurs=0 

1,3 

I'lj maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

i ¥ 

□ 15 Valid values are rtl (right to left) and Itr (left to right). 

The /updateReminderRequest/reminder/offset (int minOccurs=l maxOccurs=l) field 
specifies the offset, in minutes, of how long before the event the user should be reminded. 
Recommended values are the following: 



Value 


Description 


5, 10, 20, 30, 45 


5, 10, 20, 30, 45 minutes before the event 


60, 120, 180, 


1, 2, 3 hours before the event 


startTime - startDay 


The day of the event (reminder sent at 12:00am) 
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startTime - (startDay - 


"x" days before the event (reminder sent at 12:00am 


(1440 * x)) 


"x" days before) 



The /updateReminderRequest/reminder/intermptabiUty (int minOccurs=0 
maxOccurs=l) optional element defines how interruptible this event is and it is used by 
notification routing software to make decisions about the relay and deferral of notifications 
that might occur while this meeting is active. The value contained in this element is a 
numeric value between one and ten. Low values represent a high cost of disruption, high 
values represent a low cost of disruption. 

The /updateReminderRequest/reminder/lastSentTime (dateTime minOccurs=l 
maxOccurs=l) is used by the reminder engine. The 

/updateReminderRequest/reminder/nextTriggerTime (dateTime minOccurs=l maxOccurs=l) 
field determines the next time to trigger reminder. The /updateReminderRequest/id (string 
minOccurs=l maxOccurs=l) attribute contains a reference to another .NET My Services item 
by its item ID. The uuidType is used to specify a universally unique identifier (UUID). 

Upon successfiil completion of this method, a Standard .NET My Services response 
message is generated as the myCalendar/updateReminderResponse. 

my Calendar /Examples 

By way of example, .consider this stripped-down view of a sample user's calendar: 

<myCalen(kr> 
<event> 

<body> 

<cat ref="hs:public"/> 

<title xml:lang="en" dir="ltr">Meet with attomeys</title> 
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<startTime> 2001-09-14T19:00:00Z </startTime> 

<endTiine>2001-09-14T20:00:00Z</endTime> 

<organizer> 

<name>Johii Doe</naine> 
<email>jo]indoe@nucrosoft.com</email> 

</organizer> 
</body> 
</evenP* 

</myCalendar> 

As can be seen from the various descriptions above, when interpreted by a calendar 
application, this would result in a single meeting on the calendar that takes place at noon 
Pacific Standard Time and lasts one hour. 

As a more complex example, consider the following table: 



<m:myCalendar 

xmlns:m="http://schemas.microsoft.coni/hs/2001/10/myCalendar'' 
xmlns:hs="http://schemas.niicrosoft.coni/hs/2001/10/core"> 

<m:event 

caleTidarType="2"> 
<ni:body> 

<m:title xml:lang="en" dir="ltr">Meet for coffee</m:title> 
<m:fullDescription xml:lang="en" dir="ltr"> 

Meet at the local coffee place to discuss 
our meeting this Monday, 
It takes about 30 minutes to get there. 
<m: fullDescription> 

<m:location> Joe's coffee shop</m:location> 

<startTime>2001-09-14T13:20:00-8:00</startTime> 

<endTime>2001-09-14T14:20:00-8:00</endTime> 

<allDay>False</allDay> 

<travelTimeTo>30</travelTimeTo> 

<travelTimeFrom>30</travelTimeFrom> 

<freeBusyStatus>away</freeBusyStatus> 

<m:organizer> 

<hs:name xml:lang="en" dir="rtr'>Bob Simth</hs:name> 
<hs:email>bobsinith@company.com</hs:email> 

</m:organizer> 
</m:body> 
<m:attachment> 

<m:name xml:lang="en" dir="rtr> 
Meeting Agenda.doc 

</m:name> ^ 
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<ni:contentType>application/msword</m:contentType> 
<m:contentTransferEncoding> 
base64 

</m:contentTransferEncoding> 
<m:size>14324</m:size> 

<m:content>4234234**32423423423423</m:content> 
</m:attachment> 
<m:reininder> 

<m:set>true</m:set> 

<m:to xml:lang="en" dir='W></m:to> 

<m:offset>30</m:offset> 

<m:lastSentTime>0000-00-OOTOO:00:00</m:lastSentTime> 
<m:nextTriggerTime> 

2001-09-14712:50:00-8:00 
<;/m:nextTriggerTime> 
</m:reininder> 
</m:event> 
<m:event> 
<m:body> 
<m:cat ref="hs:public"/> 

<m:title xml:lang="en" dir="...">Monday morning meeting</m:title> 
<m:fiillDescription xml:lang="en" dir=="rtr'> 

Meet to talk about tasks for the upcoming week. 
</m:fullDescription> 

<m:location xml:lang="en" dir="rtr'> Joe's coffee shop</m:Iocation> 

<m:recurrenceId>2001-09-01T08:00-8:00</m:recurrenceId> 

<m:startTime>2001-09-01T08:00-8:00<;/m:startTime> 

<m:endTime>2001-09-01T09:00-8:00<;/m:endTime> 

<m:allDay>false</m:allDay> 

<m:floating>false</m:floating> 

<m:travelTimeTo>30</m:travelTimeTo> 

<m:travelTimeFrom>30</m:travelTimeFrom> 

<m:fi:eeBusyStatus>busy</m:freeBusyStatus> 
</m:body> 
<m:recurrence> 

<m:rule> 

<m:creationDate>2001-09-01T08:00-8:00</m:creationDate> 

<m:firstDayOfWeek>su</m:firstDayOfWeek> 

<m:isLeapYear>false</m:isLeapYear> 

<m:repeat> 

<m:weekly su-"..." mo="true'' tu=="..." we="..." 

th-".,." fr=".,." sa=**..." weekFrequency="...'V> 
<m:monthlyByDay su="..." mo="..." tu="..." we="..." 

th=".,." fr="..." sa="..." 

monthFrequency=".. " weekdayOfM:onth="..."/> 
<m:monthly monthFrequency=",.." day="../' 
forceExact="...'V> 

<m:yearlyByDay su="..;' mo="„." tu="„," we="..." 
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th="..." fr="..." sa="..;' yearFrequency="..." 
weekdayOfMonth="..." month="..."/> 
<m:yearly yearFrequency="..." month-'..." day="..." 

forceExact="..."/> 

</m:repeat> 

<m: windowEnd>2002-0 1 -0 1 T 1 2 :00</m: windowEnd> 
<m:repeatForever>false</m:repeatF orever> 
<m:repeatInstances/> 
</m:rule> 
</ni:recurrence> 
</m:event> 
</m:myCalendar> 



As can be seen from the descriptions above, this user has two events in a calendar. 
One event is recurring every Monday at 8:00 am, and the other is an upcoming event at 1 :20 



''J 5 

|;0 mvCatesories 

The .NET myCategories service is designed to support a classification model for data 
j U within the .NET My Services universe. The classification model is generic and makes very 
P few assumptions about application usage. As a result, the design is minimal and open. This 
1 0 model of categorization will be used by a wide spectrum of applications, without burdening 
the developer of the service. 

The .NET myCategories service manages a list of category defmitions. Examples of 
category definitions include child, anniversary, and employee. Each category definition has a 
human readable name and a description which contains hints about the meaning of that 
1 5 category. For example, one given category may imply a more general category, while 
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"friends" implies acquaintances. A category may be classified by using other categories. For 
example, anniversary and birthday are categorized as specialDate. 

Like other .NET My Services, the .NET Categories service exposes a global system 
document, and an identity centric content document. The global system document is an 
extension of the standard system document which contains global category definitions 
available to all .NET My Services applications. The identity-centric content document 
contains category definitions local to the identity. 

Within other .NET My Services, category references are used to mark an XML 
element as belonging to the group represented by the category definition. The schema of each 
service defmes which nodes (if any) can be categorized. For example, .NET 
Contacts/contacts/address can be categorized, but .NET Calendar/event/eventBody cannot. 
The roleList and system schemas also define nodes that can be categorized. For example, 
roleList/role can be categorized. 

Categories use a declarative syntax for encoding relationships that an application 
deems as important. .NET My Services neither provides nor requires any consistency checks 
or enforcements implied by the semantics of these relationships. 

There are two primary elements used to define and reference categories. The catDef 
element is used to define a category, and the cat element is used to refer to a category, .NET 
My Services allows the catDef element to appear in the system document of the .NET 
Categories service, the content document of the .NET Categories service and/or an arbitrary 
XML file located by a URI. 
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The cat element refers to a category definition by absolute or relative URI. The 
Unkage between the two is through the catDef/@idName attribute and the cafy@ref attribute. 
The catDe£^@idName attribute specifies the local id for the category definition, and the 
cat/@ref attribute is the value of that reference. 

The value of the cat/@ref attribute may take the following form: 
system #name-of-category 

The category definition being referenced is located in the system document of the 
.NET Categories service, and its catDe£^@idName attribute is "name-of-category". For 
example, the category reference of <cat ref="system#public'V> is a reference to the category 
definition whose catDef7@idName value is "public", and that this category definition is 
located in the system document of the .NET Categories service /,e.<catDef 
idName="pubhc"/>. 

The value of the cat/@ref attribute may also take the form: 
contentf?puid=puid'ValueJ#name-of'Category 

The category definition being referenced is located in the content document of the 
.NET Categories service, and its catDe£^@idName attribute is "name-of-categor/'. The 
instance of the .NET Categories service (i.e., the puid of the service) is imphed by the context 
of the reference. This may be made exphcit by inserting ?puid=puid-value to the URI, and 
when this is done, it means the content document of the .NET Categories service whose puid 
is "puid-value" holds the category definition. For example, the category reference of <cat 
ref=**content#LaQuintaHouse"/> is a reference to the category definition whose 
catDef/@idName value is "LaQuintaHouse", and that this category definition is located in the 
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content document of the .NET Categories service for the current puid /.^.<catDef 
idName="LaQuintaHouse"/>. 

The value of the cat/@ref attribute may also take the form: 
any''Uri#name''Of'Category 

The category definition being referenced is located in an extemal (to .NET My 
Services) resource. The "any-uri" portion of the reference refers to a resource containing the 
catDef element whose @idName attribute matches the "name-of-categor/'. The mapping 
between the "any-uri" portion of the reference and an XML document containing the catDef 
elements is a function of the "any-uri". By convention, this uri is the name of an XML 
document containing those elements. The purpose of this reference form is to allow and 
support a free form set of extended categorizations that are global and available to all. For 
example, the category reference of 

<cat ref="http://schemas.cpandl.com/im/globalCategories.xml#imBuddy'V> is a reference to 
the category definition whose catDe£^@idName value is "imBuddy", and that this category 
definition is located in an extemal resource located at 

"http://schemas.cpandLcom/im/globalCategories.xmr'. Note that it is expected that category 
definitions will exist in the appropriate locations, but there is no requirement or enforcement 
of this. 

In the various cases, the mapping between a category reference and the category 
definition is very simple. 

1 . Locate the document containing the category defimtion by taking the 
name prior to the "#". 
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2. If the document is "system", then the document containing the category 
definition is the system document of the .NET Categories service and is 
addressed using request/@service="myCategories" and 
request/@document="s5«tem". 

3. If ttie document is "content", then the document containing the category 
definition is the content document of the .NET Categories service and 
is addressed using request/@service="myCategories" and 
request/@document="content". If the ?puid=puid-value argument is 
present, the request is fiirther qualified by requesl/key/@puid- *puid- 
value". Otherwise, this attribute contains tiie puid of the document 
containing the reference. 

4. For any other document, the value is the uri of the XML document 
containing the category definition. 

5 . Locate the category id which is tiie portion of the reference after the 
"#". 

6. Wilh the document in hand, the xpath expression 
//catDef[@idName='category-id'] selects the category definition. 



mvCatesories / roles 

The myCategories service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 

scope allElements 

<hs:scopeid=7215df55-e4af-449f-a8e4-72alf7c6a987> 
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<hs:shape base=t> 
</hs:shape> 
</hs:scope> 

5 scope onlySelfElements 

<hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs:shape base^l> 

<hs:include select=//*[@creator=*$callerId']/> 
</hs:shape> 
10 </hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 
<hs:shape base=nil> 
1 5 <hs:include select=//subscription[@creator==*$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

20 <hs:scopeid=da025540-a0c0-470f-adcf-9fD7e5a5ec8f^ 
<hs:shape base==nil> 
<hs:include select=//*[cat/@ref^'hs:piiblic']/> 
Q <hs:include select==vysubscription[@^ 

</hs:shape> 
k 25 </hs:scope> 



'4 



ru 



The myCategories roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
30 roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myCategories service through that method while mapped to this 
roleTemplate: 



TABLE ■ myCategories roleTemplate rtO 



[method 


scope/name! 


[Query 


allElements j 


jhisert 


allElements i 
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jReplace 


allElements 1 


[Delete 


allElements i 


[update ] 


allElements 1 

! 



The myCategories roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in Ihe 
5 content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myCategories service through that method while mapped 
:;3 to this roleTemplate: 

•« 10 TABLE - myCategories roleTemplate rtl 



[method 


scope/name 


iQuery 


allElements 


[insert 


onlySelfElements 


Replace 


onlySelfElements; 


Delete 


onlySelfElements' 



The myCategories roleTemplate rt2 role gives complete read access to the information 
within the content document of Ihe service being protected through this roleTemplate. 
1 5 Applications mapping to this role have very Umited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myCategories service through that method 
while mapped to this roleTemplate: 



- 188- 



TABLE - myCategories roleTemplate rt2 



{method 


scope/name 


IQuery 


allElements 


[insert 


onlySelfSubscriptionElements [ 


[replace 


onlySelfSubscriptionElements^ 


[Delete i 


onlySelfSubscriptionElements; 



The myCategories roleTemplate rt3 role gives limited read access to information 
within the content document that is categorized as "public." The following table illustrates 
the available methods and the scope in effect when accessing the myCategories service 
through that method while mapped to this roleTemplate: 

myCategories roleTemplate rt3 



methodi 


scope/name i 


Query 


onlyPublicElementsj 



The myCategories roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 

mvCatesories / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myCategories service: 
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<m: my Categories changeNumber="..." instanceld="..." 
xmlns:m="http://schemas.microsoftxoni/hs/2001/10/myCa 
xmlns :hs="http ://schemas .microsoft, coni/hs/200 1 / 1 0/core">i i 
<m;catDef idName= " changeNumber =". id=" .." creator= "„.">n .mur..^^^ 

<hs:name xml:lang="..." dir="...">o..unbounded</hs:name> 

<hs:description xml:lang=" .." dir="...">o.,i</hs:description> 

<hs:impliesref="..;'>o..unbounded</hs:implies> 

<hs;cat ref="...">n„nhmiiiHPd< /hs;cat> 

fany} 
</m:catDe£> 

<m:subscription changeNumber- id="..." creator-'.. .">o..unbounded 

<hs:trigger select^"..." mode-'..." baseChangeNumber="...">i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri="...''>i..i /fl«y^</hs:contex1> 

<hs:to>i..i</hs:to> 
</m:subscription> 
{any} 

</m;myCategories> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum and maximum 
occurrence information (0, 1, unbounded) indicates whether an element or attribute is required 
or optional, and how many are possible. 

The /myCategories (minOccurs=l maxOccurs=l) element encapsulates the content 
document for the .NET Categories service. The service is designed to store identity centric 
category definitions that may be referred to using the content[?puid=puid-value]#name-of- 
category relative URI scheme. The /myCategories/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facihtate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to apphcations. Attempts to write this attribute are silently ignored. 
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The /myCategories/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a 
unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 

The /myCategories/catDef (minOccurs=0 maxOccurs=unbounded) element 
encapsulates the definition of a category and may appear in the system or content document of 
the .NET Categories service, or may appear in an external resource. 

The /myCategories/catDe£^@idName (string minOccurs=0 maxOccurs=l) attribute 
specifies the name of the category definition in the form of the category name. The 
relationship between this value, and references to this value, are defined using the rules 
outlined above. 

The /myCategories/catDe£^@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to appUcations. Attempts to vmte this attribute are silently ignored. 

The /myCategories/catDe£^@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an E) is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 
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The /myCategories/catDe£'@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/myCategories/catDefname (string niinOccurs=0 maxOccurs=unbounded) element specifies 
the localized name of the category. The /myCategories/catDef nam^@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute mdicates 
the language type of the content within this element. The /myCategories/catDe£^name/@dir 
(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myCategories/catDef/description (string minOccurs=0 maxOccurs=l) element 
specifies a full description of the category definition. The 

/myCategories/catDe£'description/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
is used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myCategories/catDef'description/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the base direction of directionally neutral text. Possible values 
include rtl (right to left), or Itr (left to right). 

The /myCategories/catDef impUes (minOccurs=0 maxOccurs=unbounded) elanent 
specifies that this category definition also implies that another category (designated by the ref 
attribute) also applies. The /myCategories/catDefimplies/@ref (anyllRI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDefi'>) element using the rules 
outlined above. 
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The /myCategories/catDef/cat (minOccurs=0 maxOccurs=unbounded) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The /myCategories/catDe£'cat/@ref 
(anyURI minOccurs=0 maxOccurs=l) attribute references a category definition (<catDe£^) 
element using the rules outlined above. 

The /myCategories/catDef7{any} (minOccurs=0 maxOccurs=unbounded) and 
/myCategories/{any} (minOccurs=0 maxOccurs=unbounded) fields allow for extensibility, 
like other "any" fields. 

mvCate2ories / System 

The system docximent is a global document for the service, having a content and 
meaning that are independent of the puid used to address the service. The document is read 
only to all users. The system document contains a set of base items common to other services 
in the .NET MyServices model, as described above in the common system section of the 
present application, (with myCategories as the *actual service name* to insert) and is 
extended to include service-specific global information by the following: 

This schema outline in the table below illustrates tiie layout and meaning of the 
information for the myCategories service, wherein the category definitions maybe referenced 
by using the syslem#name-of-category notation in tiie cat/@ref attribute as described above. 
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TABLE - myCategories / system 

: see common system 

<sys:catDef idName="..." changeNmnber= "..." id="..." C!:eator="...">o unbounded 
<hs:name xml:lang="..." dir="../'>o..unbounded</hs:name> 
<hs:description xml:lang="..." dir=".,.">o..i</hs:description> 
<lis:inq)liesref^'\./'>o..ui*omided</hs:implies> 
<hs;cat ref="../>n ,n.i...n,H.^< /lis;cat> 

</sys:catDef> 
{my} 
</sys:system> 

The meaning of the attributes and elements shown in the preceding sample document 
outline are listed below, using the syntax described above for blue (bold) and red nodes 
(underlined). The common system items are described in tiie common system documents 
section above. 

The /system/catDef (minOccurs=0 maxOccurs=unbounded) element encapsulates 
category definitions global and accessible to all .NET My Services applications. Category 
references of the form system#name-of-category may be used to refer to these category 
definitions. The /system/catDe£^@idName (string minOccurs=0 maxOccurs=l) attribute 
specifies the name of the category definition in the form of the category name. The 
relationship between this value, and references to this value, are defined using the rules 
outlined above. 

The /system/catDefi^@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
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assigned to this element by the .NET My Services system. The attribute is read-only to 

applications. Attempts to write this attribute are silently ignored. 

The /system/catDe£'@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 

ID assigned to this element by .NET My Services. Normally, .NET My Services will generate 
5 and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 

AppHcation software can override this ID generation by specifying the useClientlds attribute 

in the request message. Once an ID is assigned, the attribute is read-only and attempts to 

write it are silently ignored. 
5 ^ The /system/catDe£^@creator (string mmOccurs=0 maxOccurs=l) attribute identifies 

p 1 0 the creator in terms of userld, appid, and platformld of the node. The system/catDef/name 

'.J (string minOccurs=0 maxOccurs==unbounded) element specifies the localized name of the 

lift 

^if category. The /system/catDe£^ame/@xml:lang (minOccurs==l maxOccurs=l) required 

□ 

i ^ attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 

I y described in RFC 1766. The vahie of this attribute indicates the language type of the content 

Q 15 within this element. The /system/catDef/name/@dir (string minOccurs=0maxOccurs=l) 

optional attribute specifies the default layout direction for the localized string. VaUd values 

are rtl (right to left), and Itr (left to right). 

The /system/catDefi^description (string minOccurs=0 maxOccurs=l) element specifies 

a full description of the category definition. The /system/catDe£^description/@xml:lang 
20 (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 

the language type of the content within this element. The /system/catDef/description/@dir 
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(string minOccurs=0 maxOcciirs=l) optional attribute specifies the base direction of 
directionally neutral text. Possible values include rtl (right to left), or Itr (left to right). 

The /system/catDef^impUes (minOccurs=0 maxOccurs=unbounded) element specifies 
that this category definition also impUes that another category (designated by the ref attribute) 
also appUes. The /system/catDe£^impUes/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<cafDefi^>) element using the rules outlined above. 
The /system/catDefi^cat (minOccurs=0 maxOccurs=unbounded) element is used to categorize 
the element that contains it by referencing a global category definition in either the .NET 
Categories service system document or an external resource containing category definitions, 
or by referencing an identity centric category defmition in the content document of the .NET 
Categories service for a particular puid. 

The /system/catDefi'cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^) element using the rules outlined above. The 
/system/catDefi^{any} (minOccurs==0 maxOccurs=unbounded) and /system/ {any} 
(minOccurs=0 maxOccurs=nmbounded) fields provide for extensibiUty. 

mvContacts 

The .NET Contacts service comprises a repository for a user to store and track contact 
information and relationships for the various people and organizations that the user interacts 
with. To this end, each .NET My Services user has access to a logical contacts document 
which may contain multiple contact records. In general, the .NET Contacts service thus forms 
the foundation for an electronic address book, or a set of electronic relationships. This service 
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contains a list of contacts, organized by category, wherein a contact is a schema element 
containing an identifier (id) for the contact in the .NET My Services id space. A contact has a 
local name for that contact, a set of categories that the contact belongs to, (distribution list's, 
groups, and classifications), an address, as defined by the .NET Address schema, and a set of 
5 profile information (as defined by a corresponding .NET Profile schema). To this end, the 
.NET Contacts schema includes at least some of the .NET Profile service information 
including, but not limited to, name, addresses, phone numbers and email addresses, as well as 
allowing the owner to control how the contacts are categorized. 

Contact information stored within .NET Contacts can be derived fi'om the owner's 
□ 10 .NET Address and .NET Profile services. For example, if a user X wishes to add someone 
;! j named Y as a contact in the user's .NET Contacts service, the information used to populate 

i,| I 

:;Q this contact can be queried firom user Y's .NET Address and .NET Profile services. User Y' s 

5 

access control mechanisms determine how much information firom his or her .NET Address 
!;3 and .NET Profile services are allowed to be seen. From the user's perspective, the user can 
15 similarly control visibility of individual contacts and grant various levels access to their list of 

u 

contacts to appUcations and other users based on the role templates with respect to each user's 
relative role. Thus, for example, with the user's consent, an appUcation could populate a 
selection box with the user's contacts. From this box, the user could select a contact and the 
appUcation could fill out the "Ship To:" fields (name, address, city, state and zip) for the 
20 contact automatically, such as when making a gift: purchase. 

The ,NET Contacts service is designed to support Uve contacts. In this mode of 
operation, the queries described above that populate a contact happen automatically each time 
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a change occurs in a subscribed-to to contact. This synchronization can be enabled or 
suppressed on a contact-by-contact basis. Users and qjplications can negotiate a subscription 
to another user's Profile document via the LiveContacts mechanism. When subscribed, the 
informational nodes become read-only for that contact and automatically update when 
changed by the Profile owner. The user can still contix)l categorization, and notes for the 
LiveContact entiy. The service-to-service communications protocol (SSCP) provides a highly 
efficient, robust mechanism for such automatic updates, as described below. 



mvContacts /Roles 

The myContacts service controls access by using the roleTemplates rtO, rtl, rt2, rt3 
and rt99, using the following scopes: 
scope allElements 

<hs:scopeid=7215df55-e4af-449f-a8e4-72alf7c6a987> 

<hs:sh^e base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs:shape base=nil> 

<hs:includeselect=//*[@creator='$callerId']/> 
</hs:sliape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scopeid=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 
<hs:shape base=nil> 

<hs:includeselect=//subscription[@creator=*$callerId']/> 
<hs:shape> 

<hs:scope> 
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scope onlyPublicElements 

<hs:scope id==da025540-a0c0-470f-a(icf-9f07e5a5ec8£> 
<hs:shape base=nil> 
<hs:includeselect=//*[cat/@ref=*hs:public']/> 
<hs:include select=//subscription[@creator=*$callerId']/> 

</hs:shape> 
</hs:scope> 

The myContacts roleTemplate rtO role gives complete read/write access to the 
infomaation within the content document of the service being protected through this 
roleTemplate. 

The following table illustrates the available methods and the scope in effect when 
accessing the myContacts service through that method while mapped to this roleTemplate: 



TABLE -myContacts roleTemplate rtO 



|method { 


scope/name 


1 query 


allElements 1 


1 insert j 


allElements 


replace 


allElements 


delete 1 


allElements \ 


update 1 


allElements j 


updateContactData | 


allElements 


serviceOnline \ 


allElements 


serviceOffline j 


allElements 



The myContacts roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a hmited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
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scope in effect when accessing the myContacts service through that method while mapped to 
this roleTemplate: 



TABL E -myConta cts roleTemplate rtl 



method 


scope/name 


query 


allElements 


insert 


onlySelfElements 


replace 


onlySelfElements| 


delete 


onlySelfElements [ 


updateContactData 


allElements | 


serviceOnline 


allElements 


serviceOffline 


allElements 



|:4 

Q 5 The myContacts roleTemplate rt2 role gives complete read access to all information 



^ within the content document of the service being protected through this roleTemplate. 

'fj, Applications mapping to this role have very limited write access and are only able to create 



'^i^ and manipulate their own subscription nodes. The following table illustrates the available 

Q methods and the scope in effect when accessing the myContacts service through that method 

i y 10 while mapped to this roleTemplate. 

'J K!? 



TABLE -myContacts roleTemplate rt2 



method 


scope/name 


query j 


allElements ! 


insert | 


onlySelfSubscriptionElements ; 


replace ; 


onlySelfSubscriptionElements 


delete \ 


onlySelfSubscriptionElements i 


UpdateContactData : 


allElements i 


serviceOnline 


allElements j 


serviceOffline i 


allElements 
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The myContacts roleTemplate rt3 role gives limited read access to information within 
the content document that is categorized as **public/' The following table illustrates the 
available methods and the scope in effect when accessing the myContacts service through that 
method while mapped to this roleTemplate: 



TABLE -myContajcts roleTemplate rt3 



method j 


scope/name ^ 


Query \ 


onlyPublicElements 


updateContactData 


allElements 


jserviceOnline 


allElements ! 


IserviceOffline 


allElements | 



The myContacts roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. No methods / 
scope are in effect when accessing the myContacts service while mapped to this rt99 
roleTemplate. 



myContacts / Content 

The content document is an identity centric document, with its content and meaning a 

function of tiie user identifier (puid) used to address the service. Accessing the document is 

controlled by the associated roleList document. The following table comprises a schema 

outline that illustrates the layout and meaning of the information found in the content 

document for the myContacts service. 

<m:myContacts changeNumber- ' instanceld- ' ..." 
xmlns:m=" http://schemas.microsofl.com/hs/2001/10/myContacts" 
xmlns:mp="http://schemas.microsoftxom/hs/2001/10/myProfile" 
xmhis:mc=" http://schemas.microsoft.com/hs/2001/10/myCalendaf' 
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xmlns:hs=" http://schemas.microsoft.com/hs/2001/10/core'' >i..i 

<m:coiitact synchronize^ " ..." changeNumber =" ..." id=" ..." creator- ' ..." 

*0..unbounded 

< m;cat ref=" ..." >o„mibounded</micat> 

<m:name changeNumber =" ..." id=" ..." creator-' ..." >o.unbounded 
<mp;cat ref=" ..." >o..uiiboimded</mElcat> 
<mp:title xml:lang=" ..." dir=" ..." >o..i</mp:title> 
<mp;givenName xml:lang=" ..." dir=" ..." >n i< /mp:givenName> 
<mp:middleName xml:lang==" ..." dii=" ..." >o..i</mp:middleName> 
<mp:surname xml:lang=" ..." dir=" ..." >n i< /mp;surname> 
<mp:suffix xml:lang=" ..." dir=" ..." >o..i</mp:suffix> 
<mp:fileAsName xml:lang=" ..." dir==" ..." >a i< /mp:fiIeAsName> 

</m:name> 

< m:puid> o i< /m:puid > 

<m:specialDate calendarType- ' ..." >o..unbounded 

<mp:cat ref- ' ..." >n i< /mp:cat> 

<inp: date>i i </nq): date> 

</m:specialDate> 

<m:picture>o„iiriboimded 

<mp:cat ref= " ..." >n i< /mp;cat> 

<mp:url>i..i</mp:url> 

fanvl 
</m:picture> 

<m:gender>o..i</ni:gender> 
<m:notes xml:lang=" ..." dir=" ..." >o.,i</m:notes> 
<m:address changeNmnber =" ..." id=" ..." creator- ' ..." >o..unbounded 
<hs;cat ref=" ..." >n nnhr>.mH^H</ hs;cat> 

<hs:officialAddressLine xml:lang=" ..." dir=" ..." >o..i</hs:officialAddressLine> 

<hs:intemalAddressLine xml:lang=" ..." dir=" ..." >o..i</hs:intemalAddressLine> 

<hs:primaryCity xml:lang=" ..." dir=" ..." >o..i</hs:primaryCity> 

<hs: secondary City xmhlang- ' ..." dir=" ..." >o..i</hs:secondaryCity> 

<hs:subdivision xml:lang='' ..." dir=" ..." >o„i</hs:subdivision> 

<hs:postalCode>o..i</hs:postalCode> 

<hs:countryCode>o..i</hs:coiintryCode> 

<hs : latitude>o. . i </hs : latitude> 

<hs:longitude>o .i</hs:longitude> 

<hs: elevation>o.. i</hs :elevation> 

<hs:velocity>o..i 

<hs : speed>o.. i </hs : speed> 

<hs:direction>o..i</hs:direction> 
</hs:velocity> 

<hs :confidence>o. . i </hs : confidence> 
<hs:precision>o.,i</hs:precision> 

</m:address> 



-202- 



<m:emailAddress changeNumber- ' id="..." creator-' ..." >o.unbounded 

<mp;cat ref=" ..." >o .unboiinded</SiEicat> 

<mp:email >i i< /mp:email> 

<mp:name xml:lang=" ..." dir=" ..." >o..i</mp:name> 

fany} 
</m:emailAddress> 

<m;webSite changeNumber =" ..." id=" ..." creator- ' ..." >o..unbounded 
<inp;cat ref- ' ..." >n i< /mp;cat> 

<mp:url>i..i</mp:url> 

</m:webSite> 
<m:screenName>o..unbounded 

<mp:cat ref= " ..." >n i< /mp:cat> 

<mp;name xml:lang=" ..." dir=" ..." >i i< /mp;name> 

{any} 
</m:screenName> 

<m:telephoiieNumber changeNumber= " ..." id=" ..." creator-' ..." >o. unbounded 
< hs;cat ref=" ..." >o..unbounded</bsi£it^ 
<hs:countryCode>o..i</hs:countryCode> 
<hs:nationalCode>i..i</hs:nationalCode> 
<hs;namber >i i< /hs:number > 
<hs:numberExtension>o..i</hs:numberExtension> 
<hs:pin>o..i</hs:pin> 
{any} 

</m:telephoiieNumber> 

<m:identificationNumber>o..unbounded 
<mp:cat ref- ' ..." >n i< /mp;cat> 
<inp:number>i..i</mp:nuinber> 

</m:identificationNumber> 

<m:workInformatioii changeNnmber= " ..." id=" ..." creator^ '' ..." >o..uiiboiindcd 
<mp;cat ref= '' ..." >o..unbomided</mEI£§t^ 
<mp:profession xml:lang=" ..." dir=" ..." >o.a</tnp:profession> 
<mp:jobTitle xml:lang=" ..." dir-" ..." >o..i</mp:jobTitle> 
<nq):oflEiceLocation xml:lang=" ..." dir=" ..." >o..i</mp:officeLocation> 

<mp:coworkerOrDepartment>o..unboimded 

<hs:name xml:lang=" ..." dir=" ..." >o..i</hs:name> 

<hs:puid>o.. i </hs :puid> 

<hs: email>o.. i<^/hs: email> 

< hs;cat ref=" ..." >i i< /hs:cat> 
</mp:coworkerOrDepartment> 
fany} 

</m:workInformatioii> 

<m:userReference>o..unboundcd 
<hs:name xml:lang=" ..." dir=" ..." >o„i</hs:name> 
<hs:puid>o..i</hs:puid> 
<hs : email>o. . i </hs : email> 

<hs:cat ref- ' >i .i</hs;cat> 
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</m:userReference> 
<m:securityCertificate>o ..unbounded 

<mp;cat ref=" ..." >o..unbounded</fflEI£M^ 

<mp:certificate>i ..i</mp:certificate> 
</m: securityCertificatO 
fany} 
</m:contact> 

<in:subscription changeNttmber= " ..." id=" ..." creator ^" ..." >o..unbounded 

<hs:trigger sdect=" ..." mode=" ..." baseChangeNumber =" ..." >i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri=" ..." >i..i /fliiv;< /hs:context> 

<hs:to>i..i</hs:to> 
</m:siibscriptioii> 
{any} 
</in:myCoiitacts> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum and maximum 
occurrence information (0, 1, unbounded) indicates whether an element or attribute is required 
or optional, and how many are possible. 

The /myContacts (minOccurs=l maxOccurs=l) element encapsulates the content 
document for this service. This element establishes a global cache scope for the service and 
contains other root-level system attributes for this instance of the service. 

The /myContacts/@changeNumber (minOccurs^O maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
appUcations. Attempts to write this attribute are silently ignored, e.g., without generating an 
error. 
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The /myContacts/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a 
unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 

The /myContacts/contact (minOccurs=0 maxOccurs=unbounded) identifies a 
particular contact. The /myContacts/contact/@synchronize (string minOccurs=0 
maxOccurs=l) attribute controls and/or enables synchronization of this contact node. When 
enabled, (e.g., value of "y^s" ), .NET My Services will attempt to keep the contact nodes 
synchronized with the reference data stored in the referenced PUID's myProfile default store, 
subject to permission. A value of "no" indicates that the system should not attempt to keep 
this contact node synchronized. 

The /myContacts/contact/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useCHentlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 
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The /myContacts/contact/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. 

The /myContacts/contact/cat (minOccurs=0 maxOccurs=imbounded) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category defmition in the content document of 
the .NET Categories service for a particular puid. 

The /myContacts/contact/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDefi^>) element using the rules outlined in the 
myCategories section of the present apphcation. 

The /myContacts/contact/name (minOccurs=0 maxOccurs=^bounded) element 
encapsulates a name associated with the identity. An identity can have multiple names 
associated with it. These name nodes are not intended to be used for storing screen names or 
other electronic names, but rather to store a commonly used name for the entity. Names 
contain five parts and are meant to be combined in proper order, with spaces separating the 
parts and empty content parts excluded. 

The /myContacts/contact/name/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/name/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique JD assigned to this element by .NET My Services. Normally, .NET My 
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Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, tiie attribute is read- 
only and attempts to write it are silently ignored. 

The /myContacts/contact/name/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformld of the node. The 
/myContacts/contact/name/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The /myContacts/contact/name/cat/@ref 
(anyUORI minOccurs=0 maxOccurs=l) attribute references a category defmition (<catDef/>) 
element using the rules outlined in the myCategories section of the present application. 

The /myContacts/contact/name/title (string minC)ccurs=0 maxOccurs=l) optional 
element is designed to store a title or prefix associated with the name. Examples are 'Mr.', 
•Mrs.', 'Dr.', or any ath&c commonly used name title or prefix. The 
/myContacts/contact/name/title/@xml:lang(minOccurs=l maxOccurs=l) is a required 
attribute used to specify an ISO 639 language code or an ISO 3166 country code as described 
in RFC 1766. The value of this attribute indicates the language type of the content within this 
element. 
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The /myContacts/contact/name/title/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 

The /myContacts/contact/name/givenName (string niinOccurs=0 maxOccurs=l) 
5 optional element is meant to store the first portion of a name. The 

/myContacts/contact/name/giveaName/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/name/givenName/@dir (string minOccurs=0 
10 maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
Valid values are rtl (right to left), and Itr Oeft to right). 

The /myContacts/contact/name/middleName (string minOccurs=0 maxOccurs=l) 
optional element is meant to store the middle portion or initial of a name. The 
/myContacts/contact/name/middleName/@xml:lang (minOccurs=l maxOccurs=l) required 
15 attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/name/middleName/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
Valid values are rtl (right to left), and Itr (left to right). 
20 The /myContacts/contact/name/sumame (string minOccurs=0 maxOccurs=l) optional 

element is meant to store the last portion of a name. The 

/myContacts/contact/name/sumame/@xml:lang (minOccurs=l maxOccurs=l) required 
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attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/nanie/sumame/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
5 Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/name/suffix (string niinOccurs=0 maxOccurs=l) optional 
element is designed to store a suffix associated with the name. Examples include 'Jr.', 'Sr.', 
'HI', or any other commonly used name suffix. The 

/myContacts/contact/name/su£fix/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
10 is used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. 

The /myContacts/contact/name/suffix/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 

1 5 (right to left), and Itr (left to right). 

A complete name is usually a combination of title, givenName, middleName, surname, 
and sufBx. The /myContacts/contact/name/fileAsName (string minOccurs=0 maxOccurs=l) 
optional element is present to indicate that a different order should be used, or that the identity 
prefers to have the name filed differently. The 

20 /myContacts/contact/name/fileAsName/@xml:lang (minOccurs=l maxOccurs^l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
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described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. 

The /myContacts/contact/name/fileAsName/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
5 are rtl (right to left), and Itr (left to right). The /myContacts/contact/name/ {any} 

(niinOccurs=0 maxOccurs=unbounded) allows the My Contacts section to be extended with 
respect to name information. 

The /myContacts/contact/puid (string minOccurs=0 maxOccurs=l) element is used to 
^ specify a Passport Unique ID (PUID). The ID itself is in raw form, it is not encrypted in any 
;;^^10 way. The /myContacts/contact/specialDate (minOccurs=0 maxOccurs=unbounded) element 
encapsulates a special date that is important to this entity. Multiple special date nodes may 
Q exist. This is not a substitute for dates stored on an entity's myCalendar service, but rather 
j; j; intends to provide a convenient place to store a birth date, an anniversary date, and so on, 
|:p because these dates are frequently imported into a contact record, 
U 1 5 The /myContacts/contact/specialDate/@calendarType (string minOccurs=0 

maxOccurs=l) field identifies an enumeration which determines the kind of calendar event 



this is, based on the following table, (which can be expanded): 



Value 1 


Enumeration Constant 


Description , 


-1 i 


HSCAL_ALL_CALENDARS 


Unknown Calendar; system default | 
(HSCAL_GREGORIAN_US) j 


1 i 


HSCAL_GREGORIAN 


Gregorian (localized) calendar ! 


2 i 


HSCAL_GREGORIAN_US \ 


Gregorian (U.S.) calendar 


3 i 


HSCALJAPAN i 


Japanese Emperor Era calendar ] 


4 i 


HSCAL_TAIWAN 


Taiwan Era calendar 


5 i 


HSCAL_KOREA " 


Korean Tangun Era calendar ! 
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O i 


H^sPAT HTTRT 1 


Hijri (Arabic Lunar) calendar 


7 I 


HSCAL THAI 


Thai calendar 


8 ; 


HSCAL HEBREW 


rlCDrCW ^^i^UIlarj V/cHCIlUtU ^ 


9 1 


HSCAL GRE(jr01<JLAN_ML_t^KJiJNUll 


Or-Arrrk-n c»n IV/Tirlrnp T<9i^\ French caletidar 


10 j 


HSCAL GREGORlAJN^AKABiL. i 




11 j 


HSCAL_GREGORIAN_XLIT_.ENGLISH 


OrCgOilall ilallbllLCXaLCU JJ/liglioii 

calendar \ 


12 ' 


HSCAL GREGORL\N XLIT FRENCH 


Gregorian Transliterated French calendar ; 


n i 

i J 


HSCAL KOREA LUNAR 


Default Korea Lunar calendar 


14 


HSCAL JAPAN LUNAR 


Default Japanese Lunar calendar \ 


15 


HSCAL CHINESE_LUNAR 


Chinese Lunar calendar 


16 


HSCAL SAKA 


Indian Saka calendar J 


17 


HSCAL LUNAR ETO_CHN 


Chinese Zodiac calendar \ 


18 


HSCAL LUNAR_ETO_KOR 


Korean Zodiac calendar ^ , 


ll9 


HSCAL LUNAR ROKUYOU 


Japanese Lucky days calendar ; 



The /myContacts/contact/specialDate/cat (minOccurs=0 maxOccurs=l) element is 
used to categorize the element that contains it by referencing a global category definition in 
either the .NET Categories service system document or an external resource containing 
category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. The 
/myContacts/contact/specialDate/cat/@ref (anyURIminOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^) element using the rules outlined in the 
myCategories section of the present application (/myContacts/contact/specialDate/date (date 

minOccurs=l maxOccurs=l)). 

The /myContacts/contact/specialDate/{any} (minOccurs=0 maxOccurs=unbounded) 
provides date extensibility. The /myContacts/contact/picture (minOccurs=0 
maxOccurs=unbounded) optional element encapsulates a URL that points to a picture of liie 
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identity. The /myContacts/contact/picture/cat (minOccurs=0 maxOccurs=l) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
5 the .NET Categories service for a particular puid. The /myContacts/contact/picture/cat/@ref 
(anyURI minOccurs=0 maxOccurs=l) attribute references a category definition (<catDe£^) 
element using the rules outlined in the myCategories section of the present application. The 
/myContacts/contact/picture/url (string minOccurs=l maxOccurs=l) element contains the 
U URL that points to the actual picture. The /myContacts/contact/picture/{any} (minOccurs=0 
^1 3 1 0 maxOccurs=unbounded) provides for picture-related extensibility. 
' i The /myContacts/contact/gender (string minOccurs=0 maxOccurs=l) element 

specifies the gender for this entity. There can only be a smgle gender associated with an 
U entity. The format of this element is a single, 7-bit ASCH character with one of two possible 
i 0 values: 'm' for male, and 'f for female. The /myContacts/contact/notes (string minOccurs=0 
P 15 maxOccurs=l) element contains firee-form notes related to this contact. The 

/myContacts/contact/notes/@xml:lang (minOccurs=l maxOccurs=l) required attribute is used 
to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 1766. 
The value of this attribute indicates the language type of the content within this element. 
The /myContacts/contact/notes/@dir (string minOccurs=0 maxOccurs=l) optional 
20 attribute specifies the base direction of directionally neutral text. Possible values include rtl 
(right to left), or Itr (left to right). The /myContacts/contact/address (minOccurs=0 
maxOccurs=unbounded) element encapsulates a geographic address. The contained nodes 
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describe the geographic address in detail Typical use is one address element for each 
geographical address for this identity, e.g., a user with a primary home and a vacation home 
might have two address elements in this service. 

The /myContacts/contact/address/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/address/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once aa ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myContacts/contact/address/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
/myContacts/contact/address/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
,NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myContacts/contact/address/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDe£^>) element using the rules outlined in the 
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myCategories section of the present application. The 

/myContacts/contact/address/ofBcialAddressLine (string minOccurs=0 maxOccurs=l) 
element contains the most precise, official line for the address relative to the postal agency 
servicing the area specified by the city(s)/postalCode. When parsing an address for official 
5 postal usage, this element contains the official, parsable address line that the regional postal 
system cares about. Typical usage of this element would be to enclose a street address, post 
office box address, private bag, or any other similar official address. Internal routing 
information like department name, suite number within a building, intemal mailstop number, 
or similar properties should be placed within the intemalAddressLine element. The 

'I x;? 

i,3 10 /myContacts/contact/address/officialAddressLine/@xml:lang (minOccurs=l maxOccurs=l) 
2 required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
i; J described in RFC 1766. The value of this attribute indicates the language type of the content 
U within this element. The /myContacts/contact/address/officialAddressLine/@dir (string 
I U minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 

|=! S 

r 15 localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/address/intemalAddressLine (string minOccurs=0 
maxOccurs=l) element contains intemal routing information relative to the address specified 
by the officialAddressLine. Items like department name, suite number within a building, 
intemal mailstop number, or similar properties should be placed within this element. 
20 The /myContacts/contact/address/intemalAddressLine/@xml:lang (minOccurs=l 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
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country code as described in RFC 1766. The value of this attribute indicates the language type 

of the content within this element. 

The /myContacts/contact/address/intemalAddressLine/@dir (string minOccurs=0 

maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
5 Valid values are rtl (right to left), and Itr (left to right). The 

/myContacts/contact/address/primaryCity (string minOccurs=0 maxOccurs=l) element 
defines the primary city for this address. The 

/myContacts/contact/address/primaryCity/@xnil:lang (minOccurs=l maxOccurs=l) required 
U attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
iiilO described in RFC 1766. The value of this attribute indicates the language type of the content 
"4 within this element. The /myContacts/contact/address/primaryCity/@dir (string minOccurs=0 
;;i maxOccurs=l) optional attribute specifies the default layout direction for the locaHzed string. 
U VaUd values are rtl (right to left), and hr (left to right). 

fy The /myContacts/contact/address/secondaryCity (string minOccurs=0maxOccurs=l) 

^■3 1 5 optional element defines the secondary city for this address. Example types for this element 
include city district, city wards, postal towns, and so on. The 

/myContacts/contact/address/secondaryCity/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
20 within this element. The /myContacts/contact/address/secondaryCity/@dir (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 
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The /myContacts/contact/address/subdivision (string minOccurs=0 maxOccurs=l) element 
contains the official subdivision name within the country or region for this address. In the 
United States, this element would contain the two-letter abbreviation for the name of the state. 
This element is also commonly treated as the "first order admm subdivision" and will 
5 typically contain subdivision names referring to administrative division, Bundesstaat, canton, 
federal district, province, region, state or territory. The 

/myContacts/contact/address/subdivision/@xml:lang (minOccurs=l maxOccurs=l) is a 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
^ described in RFC 1766. The value of this attribute indicates the language type of the content 
Q 1 0 within this element, while the /myContacts/contact/address/subdivision/@dir (string 

minOccurs=0 maxOccurs==l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

1:4; The /myContacts/contact/address/postalCode (string minOccurs=0 maxOccurs=l) 

Q 

fy element contmns the official postal code for this address. The 

I 15 /myContacts/contact/address/countryCode (string minOccurs=0 maxOccurs=l) element 

contains the 2 letter ISO-3 166 id of the country, dependency, or fimctionally equivalent region 
for this address. 

The /myContacts/contact/address/latitude (string minOccurs=0 maxOccurs=l) element 
specifies the latitude value for this address in units of decimal degrees while the 
20 /myContacts/contact/address/latitude/longitude (string minOccurs=0 maxOccurs=l) element 
specifies the longitude value for this address in units of decimal degrees. The 

/myContacts/contact/address/latitude/elevation (string minOccurs^O maxOccurs=l) element 
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specifies the elevation above sea level with respect to WGS84 geodetic datum, in units of 
meters. Geodetic datum WGS84 is required for these elements. The 
/myContacts/contact/address/latitude/velocity (minOccurs=0 maxOccurs=l) element specifies 
the last reported velocity associated with this address. Of course for fixed addresses, the 
velocity node would either not be present, or speed would be zero indication stationary 
position. The /myContacts/contact/address/latitude/velocity/speed (string minOccurs=0 
maxOccurs=l) element specifies the last known speed associated with this report in units of 
meters per second. The /myContacts/contact/address/latitude/velocity/direction (string 
minC)ccurs=0 maxOccurs=l) element specifies the last known direction associated with this 
report in units of degrees decimal. The /myContacts/contact/address/latitude/confidence 
(string minOccurs=0 maxOccurs=l) element specifies a percentage value that indicates the 
confidence value that this location is accurate within the specified precision. The 
/myContacts/contact/address/latitude/precision (string minOccurs=0 maxOccurs=l) element 
specifies the precision in meters of this location. The value defines a spherical zone that the 
location falls within. 

The /myContacts/contact/address/{any} (minOcciirs==0 maxOccurs==unbounded) field 
allows extensibility of address information. 

The /myContacts/contact/emailAddress (minOccurs=0 maxOccurs=unbounded) 
element encapsulates an electronic address for this entity, specifically, it contains an email 
address associated with this identity. This element maybe repeated my number of times. 
Typical use is one emailAddress element for each email address associated with this identity. 
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The /myContacts/contact/emailAddress/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the ,NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 
5 The /myContacts/contact/emailAddress/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during m insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 

1^ ^ useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 

^^10 and attempts to write it are silently ignored. 

, The /myContacts/contact/emailAddress/@creator (string minOccurs=0 maxOccurs=l) 

r^* 

i i attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
! A /myContacts/contact/emailAddress/cat (minOccurs==0 maxOccurs=unbounded) element is 

i y used to categorize the element that contains it by referencing a global category definition in 

• y 

! f 15 either the .NET Categories service system document or an extemal resource containing 

category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. 

The /myContacts/contact^emailAddress/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDefi'>) element using the rules 
20 outlined in the myCategories section of the present application. The 

/myContacts/contact/emailAddress/email (string minOccurs=l maxOccurs=l) element 
contains the actual value of the email address (e.g. someone@microsoft.com). The 
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/myContacts/contacl/emailAddress/naine (string minOccursK) maxOccurs=l) element 
contains the friendly, or display name associated with this email address. The 
/myContacts/contact/emailAddress/name/@xml:iang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 coimtry code as 
5 described in RFC 1 766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/emailAddress/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and Itr (left to right). 

14 The /myContacts/contact/emailAddress/{any} (minOccurs=0 maxOccurs=unbounded) 

1= 310 allows for extensibility with respect to email contacts. 

, I The /myContacts/contact/webSite (minOccurs=0 maxOccurs=unbounded) element 

•:M 

ri encapsulates an electronic address for this entity, specifically, it contams a web site or URL 
!= «^ associated with this identity. This element may be repeated any number of times. Typical use 

is one WebSite element for each web site associated with this identity. The 
; 15 /myContacts/contact/webSite/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The /myContacts/contact/webSite/@id (minOccurs=0 maxOccurs=l) attribute is a 
20 globally unique ID assigned to this element by .NET My Services. Normally, .NET My 

Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
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useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myContacts/contact/webSite/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. 
The /myContacts/contact/webSite/cat (minC)ccurs=0 maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories sendee for a particular puid. The /myContacts/contact/webSite/cat/@ref 
(anyURI minOccurs=0 maxOccurs=l) attribute references a category definition (<catDefi'>) 
element using the rales outlined in the myCategories section of the present application. 
The /myContacts/contact/webSite/url (string minOccurs=l maxOccurs=l) element contains 
the URL for this web site. If the site is accessible through multiple URLs, this element maybe 
repeated an appropriate number of times. 

The /myContacts/contact/webSite/{any} (minOccurs=0 maxOccurs=unbounded) 

provides extensibility. 

The /myContacts/contact/screenName (minOccurs=0 maxOccurs=unbounded) element 
encapsulates an electronic address for this entity, specifically, it contains a screen name 
commonly used in real time communications applications like instant messaging applications, 
chat rooms, and so on. This element may be repeated any number of times, and the type 
attribute may be used for simple classifications on the screenName. The 
/myContacts/contact/screenName/cat (minOccurs=0 maxOccurs=l) element is used to 



-220- 



categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myContacts/contact/screenName/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDe£^>) element using the rules outlined in the 
myCategories section of the present application. The /myContacts/contact/screenName/name 
(string minOccurs=l maxOccurs=l) element contains the value of the screen name. 
The/myContacts/contact/screenName/name/@xml:lang (niinOccurs=l maxOccurs=l) 
This required attribute is used to specify an ISO 639 language code or an ISO 3166 country 
code as described in RFC 1766. The value of this attribute indicates the language type of the 
content v^ithin this element. The /myContacts/contact/screenName/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
locaUzed string. Vahd values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/screenName/{any} (minOccurs=0 maxOccurs==unbounded) 
The /myContacts/contact/telephoneNumber (minOccurs=0 maxOccurs=unbounded) element 
encapsulates an electronic address for this entity, specifically, it contains a telephone number 
This element may be repeated any number of times. Typical use is one telephoneNumber 
element for each phone number associated with this identity. A telephone number comprises 
an optional country code, a required nationalCode (e.g., US area code), a number, an optional 
extension, and an optional pin (described below). 



-221- 



The /myContacts/contact/telephoneNiimber/@changeNmnber (minOccurs=0 
maxOccurs=l) changeNnmber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 
5 The /myContacts/contact/telephoneNumber/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 

H useCIientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 

f 

: 3 1 0 and attempts to write it are silently ignored. 

yn The /myContacts/contact/telephoneNumber/@creator (string minOccurs=0 

;>•!!« 

□ maxOccuns=l) attribute identifies the creator in terms of userld, appid, and platformid of the 

node. The /myContacts/contact/telephoneNumber/cat (minOccurs==0 m^Occurs=unbounded) 
!:H element is used to categorize the element that contains it by referencing a global category 
15 definition in either the .NET Categories service system document or an external resource 

containing category definitions, or by referencing an identity centric category definition in the 
content document of the .NET Categories service for a particular puid. The 
/myContacts/contact/telephoneNumber/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
20 myCategories section of the present application. 

The /myContacts/contact/telephoneNumber/countryCode (string minOccurs=0 
maxOccurs=l) optional element specifies the country code for this telephone number. 
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The /myContacts/contact/telephoneNumber/nationalCode (string minOccxirs=l maxOccurs=l) 
element specifies the national code for this phone number. For US telephone numbers, this is 
equivalent to the area code. The /myContacts/contact/telephoneNumber/number (string 
minOccurs=l maxOccurs=l) element specifies the actual telephone number within tiie 
country and national code nimiber scheme. 

The /myContacts/contact/telephoneNumber/numberExtension (string minOccurs=0 
maxOccurs=l) optional element specifies an extension used to reach this identity and this 
number. The /myContacts/contact/telephoneNumber/pin (string minOccurs=0 maxOccurs=l) 
optional element specifies a pin number used on this phone number, A pin is similar to an 
extension, but pin's are commonly used to address pagers while extensions are typically used 
to address phones relative to a local pbx. The /myContacts/contact/telephoneNumber/{any} 
(minOccurs=0 maxOccurs=unbounded) allows telephone number extensibility. 

The /myContacts/contact/identificationNumber (minOccurs=-0 
maxOccurs=uribounded) 

optional element encapsulates an identification number for the entity. For example, 
information such as an employee ID number, social security number, national ID number, 
drivers license number, and so on, may be stored within this element. The 
/myContacts/contact/identificationNumber/cat (minOccurs=0 maxOccurs=l) element is used 
to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The 



-223- 



/myContacts/contact/identificationNumber/caiy@ref (anyU^ minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDefi^>) element using the rules outlined in the 
myCategories section of the present appUcation. The 

/myContacts/contact/identificationNumber/number (string minOccurs=l maxOccurs=l) 
5 element contains the actual identification number value. The 

/myContacts/contact/identificationNumber/{any} (minOccurs=0 maxOccurs==unbounded) 
provides extensibility for identification number type of information. 

The /myContacts/contact/worklnfonnation (minOccurs=0 maxOccurs=unbounded) 
J , element encapsulates work-related or occupation-related information for this entity. 
□ 1 0 The /myContacts/contact/workInformation/@changeNumber (minOccurs=0 maxOccurs=l ) 
• J changeNumber attribute is designed to facilitate caching of the element and its descendants. 

J This attribute is assigned to this element by the .NET My Services system. The attribute is 

'(J 

1^^^, read-only to applications. Attempts to write this attribute are silently ignored. 

•:;«? 

i y The /myContacts/contactAvorkInfbrmation/@id (minOccurs=0 maxOccurs=l) 

;;3 15 attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services will generate and assign this ID during an insertRequest operation, or 
possibly during a replaceRequest. AppUcation software can override this ID generation by 
specifying the useChentlds attribute in the request message. Once an ID is assigned, the 
attribute is read-only and attempts to write it are silently ignored. 
20 The /myContacts/contact/workInfonnation/@creator (string minOccurs=0 

maxOccurs==l) attribute identifies the creator in terms of userld, appid, and platformid of the 
node. The /myContacts/contact/worklnformation/cat (minOccurs=0 maxOccurs=unbounded) 
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element is used to categorize the element that contains it by referencing a global category 
definition in either the ,NET Categories service system document or an extemal resource 
containing category definitions, or by referencing an identity centric category definition in the 
content document of the .NET Categories service for a particular puid. 

The /myContacts/contact/workInformation/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDe£^>) element using the rules 
outlined in the myCategories section of the present application. The 
/myContacts/contact/worklnformation/profession (string minOccurs=0 maxOccurs=l) 
This optional element specifies the entity's profession within this particular workJnformation 
element. The /myContacts/contact/workhifonnation/profession/@xml:lang (minOccurs=l 
maxOccurs=l) is a required attribute used to specify an ISO 639 language code or an ISO 
3166 country code as described in RFC 1766. The value of this attribute indicates the 
language type of the content within this element. The 

/myContacts/contact/workInformation/profession/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the locahzed string. Valid values 
are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/worklnformation/jobTitle (string minOccurs=0 
maxOccurs==l) element specifies the job title for this piece of work information. The 
/myContacts/contact/workInformation/jobTitle/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myContacts/contact/workInformation/jobTitle/@dir (string 



-225- 



minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /niyContacts/contact/worklnformation/officeLocation (string minOccurs=0 
maxOccurs=l) element specifies the office location for this piece of work information. 
The /myContacts/contact/workInformation/officeLocation/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myContacts/contact/workInformation/officeLocation/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/worklnformation/coworkerOrDepartment (niinOccurs=0 
maxOccurs=unbounded) element encapsulates information about this entity's manager, 
assistant, company, department, and so on. The information can include its name, its PUID 
and its email address. Using this anchor information, additional details may be obtained. The 
required cat element indicates the relationship of the element to this entity (e.g., ref=" 
system#manager" ). The /myContacts/contact/worklnformation/coworkerOrDepartment/name 
(string minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing 
element. 

The/myContacts/contact/workInformation/coworkerOrDepartment/name/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
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the language type of the content within this element. The 
/myContacts/contact/workMormation/coworker(>Depato (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/worklnformation/coworkerOrDepartmen^^ (string 
minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing element. 
The /myContacts/contact/worklnformation/coworkerOrDepartment/email (string 
minOccurs=0 maxOccurs=l) optional name specifies an email address for the enclosing 
element. The /myContacts/contact/worklnformation/coworkerOrDepartment/cat 
(minOccurs=l maxOccurs=l) element is used to categorize the element that contains it by 
referencing a global category definition in either the .NET Categories service system 
document or an external resource containing category definitions, or by referencing an identity 
centric category definition in the content document of the .NET Categories service for a 
particular puid. 

The /myContacts/contact/workInformation/coworkerOrDepartment/cat/@ref (anyURI 
minOccurs=0 maxOccurs=l) attribute references a category definition (<catDe£^) element 
using the rules outlined in the myCategories section of the present application. 

The /myContacts/contact/worklnformation/ {any} (minOccurs=0 
maxOccurs=unbounded) extends the work information-related data. 

The /myContacts/contact/userReference (minOccurs^O maxOccurs=unbounded) 
includes information related to reference data. The /myContacts/contact/userReference/name 
(string minOccurs=0 maxOccurs=l) optional element specifies the name for the enclosing 
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element. The /myContacts/contact/userReference/name/@xml:lang (minOcciirs=l 
maxOcciirs=l) reqmred attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myContacts/contact/userReference/name/@dir 
5 (string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myContacts/contact/userReference/puid (string minOccurs=0 maxOccurs=l) 
optional element specifies the name for the enclosing element. The 

I ^ /myContacts/contact/userReference/email (string minOccurs=0 maxOccurs=l ) optional name 

i;3 10 specifies an email address for the enclosing element. The 

'•4 /myContacts/contact/userReference/cat (minOccurs=l maxOccurs=l) element is used to 

'ift. 

categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an external resource containing category 

□ 

definitions, or by referencing an identity centric category definition m the content document of 
: =5 15 the .NET Categories service for a particular puid. The 

/myContacts/contact/userReference/cat/@ref (anyURI minOccurs==0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present appHcation. 

The /myContacts/contact/securityCertificate (minOccurs=0 maxOccurs=unbounded) is 
20 directed to securityCertificate data. The /myContacts/contact/securityCertificate/cat 
(minOccurs=0 maxOccurs==unbounded) element is used to categorize the element that 
contains it by referencing a global category definition in either the .NET Categories service 
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system document or an extemal resource containing category definitions, or by referencing an 
identity centric category definition in the content document of the .NET Categories service for 
a particular puid. The /myContacts/contact/securityCertificate/cat/@ref (anyURI 
minOcciu:s=<) maxOccurs=l) attribute references a category definition (<catDe£^>) element 
using the rules outlined in the myCategories section of the present appUcation. 

The /myContacts/contact/securityCertificate/certificate (hexBinary minOccurs=l 
maxOccurs=l) includes the certification information, and the /myContacts/contact/{any} 
(minOccurs=0 maxOccurs=unbounded) allows for extensibility. 

The system document is a global document for the service. Its content and meaning is 
independent of the puid used to address the service, and the document is read only to all users. 
The system document contains a set of base items common to .NET My Services, described 
above, with the *actual service name* equal to myContacts. 

mvContacts / Domain Specific Methods 

The myContacts service supports the standard methods query, insert, replace, delete, 
update, and the domain-specific methods updateContactData, serviceOnline and 
serviceOffline. 

mvDevices 

The .NET Devices service is designed to store a combination of characteristics about 
primarily mobile communication devices, along with the carriers which provision those 



-229- 



devices. This service is primarily designed to allow notifications, messages and other real- 
time communications to be delivered to a wide variety of devices on various transports. 



mvDevices /Roles 

5 The myDevices service controls access by using the rtO, rtl, rt2, rt3 and rt99 

roleTemplates, using the following scopes: 
scope allElements 

<hs:scope id-721 5df55-e4af-449f-a8e4-72alf7c6a987> 
<hs:shape base=t> 
10 </hs:shape> 
</hs:scope> 

Q scope onlySelfElements 

<hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 
15 <hs:shape base=nil> 

;;Ji <hs:include select=^*[@creator=*$callerId']/> 

</hs:shape> 
</hs:scope> 

U& 

i; J 20 scope onlySelfSubscriptionElements 

rU <hs:scope id-b7f05a6d-75cd-4958-9dfb-532ebbl7743> 

i y <hs:shape base=nil> 

i--'^ <hs:include select=//subscription[@creator='$callerId']/> 

-'^ </hs:shape> 
25 </hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8f> 
<hs:shape base=nil> 
30 <hs:include select=//*[cat/@ref='hs:public']/> 

<hs:include select==//subscription[@creator=*$callerId']/> 
</hs:shape> 
</hs:scope> 



35 
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The myDevices roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myDevices service through that method while mapped to this 
roleTemplate: 

TABLE - my Devices roleTemplate rtO 



method 


scope/name; 


Query 


allElements 


Insert 


allElements 


Replace 


allElements 


Delete 


allElements ! 


Update 


allElements 



The myDevices roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myDevices service through that method while mapped to 
this roleTemplate: 

T ABLE - myDevices roleTemplate rtl 



method 


scope/name 


Query 


allElements 


Insert 


onlySelfElements 


Replace 


onlySelfElements 


Delete 


onlySelfElements 
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The myDevices roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myDevices service through that method 
while mapped to this roleTemplate: 



TABLE - myDevices roleTemplate rt2 



method 


scope/name 


Query 


allElements 


Insert 


onlySelfSubscriptionElementsi 


replace 


onlySelfSubscriptionElements 


Delete 


onlySelfSubscriptionElements; 



The myDevices roleTemplate rt3 role gives limited read access to information within 
the content document that is categorized as "public." The following table illustrates the 
available methods and the scope in effect when accessing the myDevices service through that 
method while mapped to this roleTemplate: 

myDevices roleTemplate rt3 



method 


scope/name 


Query 


onlyPublicElements j 



The myDevices roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 
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mvDevices / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myDevices service: 



<m:myDevices changeNumber - \ . instanceld="..." 
xmtas:m="http://schemas.microsoft.coin/hs/2001/10/myDevices'' 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:device changeNumber= " . . id=" cr^tor-*...">o. unbounded 

< m;cat ref- '...">o..unbounded</ffll£at> 

<iii:deviceld> i i< /m;deviceld > 

<m;carrierld> i i< /m;carrierld> 

<m:name xml:lang="..." dir="...">i..i</m:name> 

< m;address> fl „«iv.«nH^H< /m:address> 

{any} 
</m:device> 

<m:sub$cription changeNttmber= ". . id="..." creator= ",..">n „nhn.mHeH 

<hs:trigger select-'../' mode- baseChangeNumber="..,">i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri=",..">i.,i /i(iiij!/</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscription> 
{any} 

</m:inyDevices> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in Ihe syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 
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The /myDevices (minOccurs=l maxOcciirs=l) element encapsulates the content 
document for the .NET Devices service. The /myDevices/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants* This attribute is assigned to this element by the .NET My Services system. The 
5 attribute is read-only to appUcations. Attempts to write this attribute are silently ignored. 

The /myDevices/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service, 
i^^^ The /myDevices/device (minOccurs=0 maxOccurs==unbounded) element defines a 

i;3 10 communication device within the .NET Devices service. Each device is an extensible, 
2 categorized item containing the name of the device encoded as a URI, the name of the carrier 

i. a 5 

that services the device encoded as a URI, a fiiendly name for the device, a list of URIs that 
Ui, may be used to address the device, and so on. 

: tj Devices are categorized into classes using simple categorization. For instance, a 

15 device is classified as a cellPhone through the "system#callPhone" categorization. 
Additionally, a device is marked as a primary device through categorization using the 
"system#primary" category reference. 

A validated device is one that has been digitally signed and certified by some entity. 
.NET My Services accommodates this by allowing the use of extension elements holding 
20 certified digital signatures, or holding references to verification services that may vaUdate a 
node on the fly. 
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The /myDevices/device/@changeNimiber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored, 
5 The /myDevices/device/@id (minOccurs=0 maxOccurs=l) attribute is a globally 

unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaccRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 

Q 10 only and attempts to write it are silently ignored. 

M . 

'^f The /myDevices/device/@creator (string minOccurs=0 maxOccurs=l) attribute 

I-™ identifies the creator in terms of userld, appid, and platformid of the node. 
1,4, The /myDevices/device/cat (minOccurs=0 maxOccurs=unbounded) element is used 

i y to categorize the element that contains it by referencing a global category definition in either 
i 15 the .NET Categories service section, described above, an extemal resource containing 

category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. 

The /myDevices/device/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^>) element using the rules outlined in the 
20 myCategories section described above. 

The /myDevices/device/deviceld (anyURI minOccurs=l maxOccurs=l) element 
contains the device name/id in a URI form. This element is encoded as a URI to allow much 
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richer and extensible naming for the device than can be expressed using a simple uuid. The 
URl name will be of tiie form http://mydevices.microsoft.com/carrierID/deviceID#9c20f0e8- 
c0ef-472d-8bec-4cc6f8b0f456. 

The /myDevices/device/carrierld (anyURI minOccurs=l maxOccurs=l) element 
5 contains the URI of the carrier that is responsible for servicing this device. The element is 
encoded as a URI. Which allows for both uuid: based identification of the carrier as well as 
richer identification mechanisms. 

The /myDevices/device/name (string minOccurs=l maxOccurs=l) element contains a 
: ^ user-readable, not necessarily unique friendly name for the device. The 
Q 10 /myDevices/device/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute is used 
' 4 to specify an ISO 639 language code or an ISO 3 1 66 country code as described in RFC 1 766. 

The value of this attribute indicates the language type of the content within this element. The 
/myDevices/device/name/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
\U specifies the default layout direction for the localized string. Valid values are rtl (right to left), 
15 and Itr (left to right). 

The /myDevices/device/address (anyURI minOccurs=0 maxOccurs=unbounded) 
element contains addresses in the form of URI' s that may be used to address this device. For 
example, if the device is addressable through email, an address entry of 
**mailto:someone@microsoft.com" may appear in this element. If the device is also 
20 addressable through an http gateway, an additional address of 

*littp://microsoft.com/somepath/someid" may be specified in this element. This element is 
repeated for each address that may be used to address the device. 
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The /myDevices/device/{any} (mmOccurs=0 maxOccurs=unbounded) allows for 
extensibility of this schema. 

mvDocuments 

5 The ,NET Documents service is designed to store and manage online files and folders 

for the associated .NET Passport. Files are provided on demand to .NET-based services, 
applications, and devices. The service can be used for roaming of personal files, or sharing 
files with other .NET Passport users, 
j.^^ By way of example, consider a consumer web site that contains product brochures in 

i;3 10 .pdf format. On the web site, the user selects "Add this file to my .NET Docimients" to 
automatically retain a copy of the brochure. As another example, a corporation's intemal 

up- 

expense report management web site allows a user to submit an expense report ,xls file that is 
U stored either on the local disk or fi:om the user's .NET Documents. As yet another example, 
1 y tax preparation software can open a user's data files either on the local disk, or from the user's 
15 .NET Documents. The user may allow a tax advisor to see and update the data files contained 

in the user's .NET Documents, which allows the tax advisor to directly update the user's data. 



mvDocuments /Roles 

The myDocuments service controls access by using the rtO, rtl, rt2, rt3 and rt99 
20 roleTemplates, using the following scopes: 
scope allEIements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 
<hs:shape base=t> 
<;/hs:shape> 
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</hs:scope> 



scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 
5 <hs:shape base=nil> 

<hs:mclude select=//*[@creator='$callerId*]/> 
</hs:shape> 
<hs:scope> 

10 scope onlySelfSubscriptionElements 

<hs:scope id=b7fD5a6d-75cd-4958-9dfb-f532ebbl7743> 
<hs:shape base=nil> 
<hs:include select=//subscription[@creator=*$callerId']/> 

</hs:shape> 
15 </hs:scope> 

scope onlyPublicElements 

jJl <hs:scope id=da025540-a0c0-470f-adcf^9fD7e5a5ec8f> 

□ <hs:shape base=nil> 

M 20 <hs:include select-//*[cat/@ref^'hs:public']/> 

<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 



m 



□ 25 

ill 



The myDocuments roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myDocuments service through that method while mapped to this 
30 roleTemplate: 



TABLE - my Docum ents roleTemplate rtO 



method 


scope/namei 


Query 


allElements j 


Insert 


allElements ; 


Replace 


allElements i 
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Delete 


allElements | 


Update 


allElements | 



The myDocuments roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited abihty to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myDocuments service through that method while mapped 
to this roleTemplate: 



TABLE - myDocmnents roleTemplate rtl 



method 


scope/name 


Query 


allElements 


Insert 


onlySelfEIements 


Replace onlySelfElementsi 


Delete 


onlySelfElementS; 



The myDocuments roleTemplate rt2 role gives complete read access to the 
information within the content document of the service being protected through this 
roleTemplate. Applications mapping to this role have very limited write access and are only 
able to create and manipulate their own subscription nodes. The following table illustrates the 
available methods and the scope in effect when accessing the myDocuments service through 
that method while mapped to this roleTemplate: 
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TABLE - myDocuments roleXempIate rt2 



method 


scope/name 


Query 


allEIements 


Insert 


onlySelfSubscriptionElements 1 


replace 


onlySelfSubscriptionElements \ 


Delete 


onlySelfSubscriptionElements' 



The myDocuments roleTemplate rt3 role gives limited read access to information 
within the content document that is categorized as "public." The following table illustrates 
5 the available methods and the scope in effect when accessing the myDocimients service 
through that method while mapped to this roleTemplate: 

myDocuments roleTemplate rt3 



method 


scope/name 


Query 


onlyPublicElementsj 



m 

The myDocuments roleTemplate rt99 blocks access to the content document. Note that 

Ms ' 

53 10 lack of a role in the roleList has the same effect as assigning someone to rt99. 

ry 

;.T myDocuments / Content 

The content document is an identity centric document, with its content and meaning a 
fimction of the user identifier (puid) used to address the service. Accessing the document is 
15 controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myDocuments service: 

<m:myDocumeiits changeNumber -'..." instanceld="..." 

xmlns:m="http ://schemas.microsoft . com/hs/200 1/1 0/myDocimients" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">L.i 

<m;doeument changeNumber=''..." id- creato r =''...''>o nnhnnnH^H 
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<m:catret= ... >o..unbounded</ni:cat> 




<m:name xml:lang= ... dir= ... >i i</m:name> 




<m:lock taken= ... expires= ... >o..i</ni:lock> 




<m:attributes>o..i 




<m:hidden>i i</m:hidden> 




<m:system>i i </m:system> 




<m:readOnly>i ..i</m:readOnly> 




</m:attnbutes> 




<m:lastAccessDate>o..i</in:lastAccessDate> 




<m:creationDate>o..i</m:creatioiiDate> 




<m:reffolderId= ... name- .. . expires= ... >n.imhoimded 




<ni:delete>o..i'^/i^'delete> 




<m : sho w>o . . i </ni : sho w> 




{any} 




</m:reL> 




<m: stream name- ... nrei= ... size- ... >i..imhoiinded 




<m:nttpHeaaers>o.a</m:n1tpHeaaers> 




<m :body>o., i </m:body> 




{any} 




</m:streain> 




<m:DroDerties chanseNumber= ... id- ... creator= ... 


">o.,i /a/ij;y</m:properties> 






</m: dociimeiit> 




<m:lolder parent= ... patn= ... cnanpeiNumber= ... id- 


- ... creator- ... >0._imhnimded 


^ 1-1 Ct991'44 99^ ^ / ^ 

<m:name xml:lang= ... dir= ... >i i</m:naine> 




<m: attributes>o.. 1 




<m:hidden>i ..i<;/m:hidden> 




<m : system>i . . i </m: system> 




<m:readOnly>i„i</m:readOnly> 




</m:attributes> 




{any} 




</m:lolder> 




<m:quota>o.i 




<m:provisioned>i..i</m:provisioned> 




<m:used>i..i</m:used> 




</m:quota> 




<m:subscription changeNumber-*..." id="..." creator=". 


• • ^0.. unbounded 


<hs:trigger select="../' mode-'..." baseCharigeNximber="...">i..i</hs:trigger> 


<hs : expires At>o. . i </hs : expires At> 




<hs:context uri="...">i..i /a/iyj</hs:context> 




<hs:to>i..i</hs:to> 




</m:subscription> 








</m:myDocumeiits> 
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The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myDocuments (minOccurs=l maxOccurs=l) element encapsulates the content 
document for the service. The .NET Documents service provides scaleable storage for opaque 
file data. While some of the meta data can be promoted into the ,NET My Services content 
document, the primary purpose of this service is to provide file storage, and to allow other 
services to access and grant access to this data. The cache scope for this document is the 
entire content document; that is, there is a single changeNumber attribute, and it occurs at the 
root element. Any change to the document changes this attribute. 

The /myDocuments/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facihtate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
appUcations. Attempts to write this attribute are silently ignored. 

The /myDocuments/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a 
unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 
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The /myDocuments/document (minOccxirs=0 maxOccurs=iinbounded) node is 
directed to the document, which is the myDocuments root object for document properties, 
references, and content. The /myDociiments/document/@changeNumber (minOccurs=0 
maxOcciirs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /myDocuments/document/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. AppUcation software can override this ID generation by specifying the 
useCUentlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myDocuments/document/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. 

The /myDocuments/document/cat (minOccurs=0 maxOccurs=unbounded) element is 
used to categorize the element that contains it by referencing a global category definition in 
either the .NET Categories service system document or an extemal resource containing 
category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. 

The /myDocuments/document/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef^>) element using the rules outlined in the 
myCategories section, described above. 
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The /myDocuments/document/name (string minOccurs=l maxOccurs=l) contains the 
name of the document. The /myDocuments/document/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myDocuments/document/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Vahd values are rtl (right to left), and Itr (left to right). 

The /myDocuments/document/lock (minOccurs=0 maxOccurs=l) element is used for 
document level locking. Since locks must be taken in an atomic fashion, this method is 
necessary as opposed to a standard update. If the lock is successfully taken, then it can be 
released by simply calling the update method and setting the taken attribute to zero (00. If a 
lock has been taken, but should be renewed, set the "Force" flag to TRUE when calUng this 
method. The Force flag should only be used to renew a lock that was previously successfiiUy 
taken. Parameters include: 

1 . Query must result in a LOCK element for a specific document 

2. Single BOOL parameter "Force" which, if true, simply takes the lock, ignoring 
the current state of the Taken attribute. 

3. A datetime which specifies when the lock should automatically expire. This 
shoxild be set to a reasonably small delta ifrom the time the lock is taken to 
avoid holding locks when the client holding the lock crashes. It is best to 
periodically refi-esh the lock and have relatively small lock expirations times. 
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A /myDocuments/document/lock/@taken (int minOccurs=0 maxOccurs=l) value of 0 
indicates no lock has been taken. If 1, then a lock is being held for the document. If the lock 
has been taken, the /myDocuments/document/lock/@expires (dateTime minOccurs=0 
maxOccurs=l) optional attribute specifies when the lock should be automatically released. 
5 The /myDocuments/document/attributes (minOccurs=0 maxOccurs=l) element 

contains the file system store attributes for the document. 

The /myDocuments/document/attributes/hidden (int minOccurs=l maxOccurs=l) 
contains a value that if 0, indicates that the document should be displayed in normal UI, while 
: ^ if 1, then it should be hidden fi-om most views. 

j;3 10 The /myDocuments/document/attributes/system (int minOccurs=l maxOccurs=l) 

'[4 indicates when equal to zero (0) that the file is not a system file, while if one (1), then the file 

vn 

should be treated as a special system file. 

|,,^, The /myDocuments/document/attributes/readOnly (int minOccurs=l maxOccurs=l) 

113 

! IJ value is 0 when the document is readAvrite, or 1 if read-only. 

\'^^ 

15 The /myDocuments/document/lastAccessDate (dateTime minOccurs=0 maxOccurs=l) 

field and /myDocuments/docimient/creationDate (dateTime minOccurs=0 maxOccurs=l) 
store this self-explanatory file system information. 

The /myDocuments/document/ref (minOccurs=0 maxOccurs=unbounded) element 
defines a reference to a document. Documents are all ref counted objects. These references 

20 can be deleted through the standard delete method. When the final reference is deleted, the 
file and all associated metadata is deleted. References always refer to a specific folder. This 
means that documents conceptually "exist" within one or more Folders. The traditional "file 
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name" for the document is unique per reference. References can also specify a time to live. 
This allows other services to post data to a user's store in a temporary fashion. For example, 
they can use the user's store to create temp files. If all references have expired, then the 
document is automatically deleted. However, if any reference exists that has not expired, then 
all references, including ones that have expired, remain valid. When adding a reference to an 
existing document, the reference must refer to an existing folder ID, and the name given must 
be unique within that folder. Updates to references require that any update will leave the 
name unique within the referencing folder. If the final reference to a document is deleted, 
then the deletion of the reference results in the deletion of the document and all associated 
streams. 

The /myDocuments/document/re£^@folderId (string minOccurs=0 maxOccurs=l) 
contains the ID of the folder object that holds this reference to this object. 

The /myDocuments/document/ref^@name (string minOccurs=0 maxOccurs=l) 
contains the name of this document within this reference (folder). 

The /myDocuments/document/re£^@expires (dateTime minOccurs=0 maxOccurs=l), 
when this attribute exists, specifies the number of minutes this reference is valid relative to the 
last access time for the document. 

The /myDocuments/document/ref/delete (int minOccurs=0 maxOccurs=l) element, if 
it exists, specifies an HTTP GET operation to be performed to cleanly delete the reference 
(this would be placed here by another service which stored data in the .NET Documents 
service). 
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The /myDocuments/document/refi^show (string minOcciirs=0 maxOccurs=l) element, 
if it exists, specifies a URL that can be used to render HTML to display the referenced object. 
For example, if the document is really a photograph in a photo album, this URL would show 
the document in the appropriate context. 
5 The /myDocuments/document/re£^{any} (minOccurs=0 maxOccurs=unbounded) 

provides for extensibility. 

The /myDocuments/document/stream (minOccurs=l maxOccurs==unbounded) element 
contains information about a single stream within a document. Documents support multiple 
streams of data. Each stream is stored as a separate object fi-om the document in the .NET My 
a 10 Services content document. Streams have names that must be imique to a given document. 
' When adding a stream, stream names must be unique for a given document. When updating a 

:; stream, stream names must be unique within a given document. The null stream can not be 

I ^ renamed. The null stream may not be deleted, while any other stream may be deleted, 
j y The /myDocmnaits/dociiinent/stream/@name (string minOccurs=0 maxOccurs=l) 

i' 2 1 

1 3 15 attribute specifies a name for the stream which is unique within this document. There is 
always one stream with the null name (""). 

The /myDocuments/document/stream/@href (string minOccurs=0 maxOccurs=l) 
attribute specifies an http reference to the actual stream object data. 

The /myDocuments/document/stream/@size (int minOccurs=0 maxOccurs=l) 
20 attribute specifies the size of the stream data in bytes. 

The /myDocuments/document/stream/httpHeaders (string minOccurs=0 
maxOccurs=l) optional element has a value that will be returned by the .NET Documents 
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service for a HTTP GET operation in the response headers. If this element is empty, then no 
additional response headers will be returned. If this element does not exist, the default 
response header for the file extension will be returned. 

The /myDocuments/document/stream/body (hexBinary minOccurs==0 maxOccurs=l) 

5 contains stream data information for the /myDocuments/document/stream/ {any} 

(minOccurs=0 maxOccurs=ninbounded) field. The /myDocuments/document/properties 
(minOccurs=0 maxOccurs=l) element defines the basic property type. 

The /myDocuments/document/properties/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to faciUtate caching of the element and its 

10 descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /myDocuments/document/properties/@id (minOccurs=0 maxOccurs=l) attribute 
is a globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 

1 5 a replaceRequest. Apphcation software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored 

The /myDocuments/document/properties/@creator (string minOccurs=0 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 

20 node. 

The /myDocuments/document/properties/{any} (minOccurs=0 
maxOccurs==unbounded) allows property-related data to be extended, while the 
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/myDocuinents/document/{any} (ininOccurs=0 maxOccurs==unbounded) provides document- 
related extensibility. 

The /myDocuments/folder (minOccurs=0 maxOcciirs=unbounded) element defines the 
basic folder type. Folders have both a path and a unique server generated id. Documents are 
5 only associated with the folder ID (through a reference), and are not "contained" within a 
folder in the .NET Documents content document. When adding a folder, the folder must have 
a unique path name, and if the folder has a parent, then the first portion of tiie folder path must 
match the path of the parent. When changing the path name of a folder, the name must not 
I ^ conflict with an existing name. If the name does not conflict then an update of a folder that is 
Q 10 the parent of other folders has the side-effect of changing the path="..." attribute of all child 

folders to reflect the new parent path name. For a folder to be deleted, there must exist no 
•1: otiier folder which is a child of Ihe folder and there must be no documents that are referenced 
by the folder. 

i U The /myDocuments/folder/@parent (string minOccurs=0 maxOccurs=l) 

'3 1 5 contains a Parent folder id, while the /myDocuments/folder/@path (string minOccurs=0 
maxOccurs=l) contains the fiiUy quaUfied path to this folder. 

The /myDocuments/folder/@changeNumber (minOccurs=0 maxOccurs==l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
20 read-only to apphcations. Attempts to write this attribute are silently ignored. 

The /myDocuments/folder/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
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generate and assign this ED during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useChentlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myDocuments/folder/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in tenns of userld, appid, and platformid of the node. 

The /myDocuments/folder/name (string minOccurs=l maxOccurs=l) contains the 
default name of the folder. The /myDocuments/folder/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is xised to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myDocuments/folder/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myDocuments/folder/attributes (minOccurs=0 maxOccurs=l) element contains 
file system store attributes for the document. The /myDocuments/folder/attributes/hidden (int 
minOccurs=l maxOccurs=l), when equal to 0, indicates that the document should be 
displayed in normal UI. If 1, then the document should be hidden from most views. 

The /myDocuments/folder/attributes/system (int minOccurs=l maxOccurs=l) 
specifies that if equal to 0, the file is not a system file. If 1, then file should be treated as a 
special system file. The /myDocuments/folder/attributes/readOnly (int minOccurs=l 
maxOccurs=l) value specifies that the document is read/write if 0, or read-only if 1 . 
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The /myDocuments/folder/{any} (minOccurs=0 maxOccurs=unboiinded) provides 
folder-related extensibility. 

The /myDocuments/quota (minOccurs=0 inaxOccurs=l) field is used by the service to 
restrict and report usage of storage. The quota element can only be updated by a client 
mapped to the Provision role. The /myDocuments/quota/provisioned (int minOccurs=l 
maxOccurs=l) value contains the maximum number of bytes of storage that can be used by 
this mstance of the .NET Documents service. The /myDocuments/quota/used (int 
minOccurs=l maxOccurs=l) field contains the number of bytes actually in use by this 
instance of the .NET Documents service. 

The /myDocuments/subscription (minOccurs=0 maxOccurs=unbounded) element 
defines a subscription node as described above in the subscription section. 

mvFavorite WebSites 

The MyFavoriteWebSites service is designed to store and manage the addresses and 
organization of the favorite web sites for an end user. Li some ways, the MyFavoriteWebSites 
service is similar to the "favorites" menu item in Internet Explorer, or the "favorites" button in 
MSN Explorer, in that both of these applications maintain a user's favorite web sites and track 
usage. .NET My Services provides this service so that favorite web sites can be used in 
multiple applications. 

mvFavoriteWebSites /Roles 
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The myFavorite WebSites service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
scope allEIements 

<hs:scope id=72 1 5df55-e4af-449f-a8e4-72al f7c6a987> 

<hs:shape base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 

<hs:includeselect=//*[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id-b7f05a6d~75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base=nil> 

<hs:include select=//subscription[@creator=*$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8fi> 
<hs:shape base=nil> 
<hs:include select=//*[cat/@ref^'hs:public']/> 
<hs:include select=//subscription[@creator=='$callerId']/> 
</hs:shape> 
</hs:scope> 



The myFavoriteWebSites roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myFavoriteWebSites service through that method while mapped to this 
roleTemplate: 
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TABLE - myFavoriteWebSites roleTemplate rtO 



method 


scope/name 


Query 


allElements 


Insert 


allElements 


Replace 


allElements 


Delete 


allElements 


Update 


allElements 



The myFavoriteWebSites roleTemplate rtl role gives complete read access to all 
information within the content document of the service being protected through this 
roleTemplate. Applications mapping to this role also have a limited ability to write to 
information in the content document. Apphcations may create nodes in any location, but may 
only change/replace, or delete nodes that they created. The following table illustrates the 
available methods and the scope in effect when accessing the myFavoriteWebSites service 
through that method while mapped to this roleTemplate: 

TABLE - myFavoriteWeb Sites roleTemplate rtl 



Imethod 


scope/name j 


IQuery 


allElements | 


|hisert 


onlySelfElementsj 


IReplace 


onlySelfElementsI 


[Delete 


onlySelfElementsj 



The myFavoriteWebSites roleTemplate rt2 role gives complete read access to the 
information within the content document of the service being protected through this 
roleTemplate. Apphcations mapping to this role have very limited write access and are only 
able to create and manipulate their own subscription nodes. The following table illustrates the 
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available methods and the scope in effect when accessing the myFavoriteWebSites service 
through that method while mapped to this roleTemplate: 

TABLE - myFavoriteWebSites roleTemplate rt2 



method 


scope/name 


Query 


allElements 


Insert 


onlySelfSubscriptionElements 


replace 


onlySelfSubscriptionElements 


Delete 


onlySelfSubscriptionElements 



The myFavoriteWebSites roleTemplate rt3 role gives limited read access to 
information within the content document that is categorized as "public." The following table 
illustrates the available methods and the scope in effect when accessing the 
myFavoriteWebSites service through that method while mapped to this roleTemplate: 

myFavoriteWebSites roleTemplate rt3 



{method 


scope/name 


iQuery 


onlyPublicElementsj 



The myFavoriteWebSites roleTemplate rt99 blocks access to the content document. 
Note that lack of a role in the roleList has the same effect as assigning someone to rt99. 

myFavoriteWebSites / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myFavoritewebsites service: 



254- 



<m:myFavoriteWebSites changeNmnber= "..." instanceld-',,." 
xmlns:m-1ittp://schemas.microsoft.coni/hs/2 
xmlns:hs="htlp://schemas.microsoftxom/hs/2001/l^ 
<m:favoriteWebSite changeNumber= ">.." id="..." creator="...">o..unbounded 

<m:cat ref="../'>n „nHnnnHPd</ m:cat> 

<m;title xml:lang="..." dir='\,;>o..unbounded</mitifle> 

<m;arl> i 1 < /m:ttrl> 

{any} 

</m:favoriteWebSite> 

<in:subscriptioii changeNumber= '\./' id="../' creator==",..''>o unbounded 

<hs:trigger select^"..." mode=",.." baseChangeNumber="...''>i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri="...">i..i /aiij;/</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscriptioii> 
{any} 

</m:myFavoriteWebSites> 

The /myfavoriteWebSites (minOccurs=l maxOccurs=l) element encapsulates the 
content document for the service. The cache scope for this document is the entire content 
document, that is, there is a single changeNumber attribute, and it occurs at the root element. 
Any change to the document changes this attribute. 

The /myfavoriteWebSites/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myfavoriteWebSites/@instanceId (string minOccurs=0 maxOccurs=l) attribute is 
a unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 
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The /myfavoriteWebSites/favoriteWebSite (minOccurs=0 maxOccurs=unbounded) 
element describes a complete favorite Web site, including the title, URL, and free-form 
extensions. This element may contain zero (0) or more category elements that are used to 
organize favoriteWebSites. 

The /myfavoriteWebSites/favoriteWebSite/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /myfavoriteWebSites/favoriteWebSite/@id (minOccurs=0 maxOccurs=l) 
attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services will generate and assign this ID during an insertRequest operation, or 
possibly during a replaceRequest. AppUcation software can override this ID generation by 
specifying the useClientlds attribute in the request message. Once an ID is assigned, the 
attribute is read-only and attempts to write it are silently ignored. 

The /myfavoriteWebSites/favoriteWebSite/@creator (string minOccurs=0 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 
node. 

The /myfavoriteWebSites/favoriteWebSite/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing a global category 
defmition in either the .NET Categories service system docimient or an external resource 
containing category definitions, or by referencing an identity centric category definition in the 
content document of the .NET Categories service for a particular puid. The 
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/myfavoriteWebSites/favoriteWebSite/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef>) element using the rules outlined in the 
myCategories section, above. 

The /myfavoriteWebSites/favoriteWebSite/title (string minOccurs=0 
maxOccurs=unbounded) element specifies the title of the favorite Web site* A typical use is 
to fill this element from the HTML <title> element in the Web site referred to by this entry. 
The/myfavoriteWebSites/favoriteWebSite/title/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myfavoriteWebSites/favoriteWebSite/title/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myfavoriteWebSites/favoriteWebSite/url (anyURI minOccurs=l maxOccurs=l) 
required element specifies the URL used to navigate to the Web site referred to by this entry. 
Its content should be URL-encoded. 

The /myfavoriteWebSites/favoriteWebSite/{any} (minOccurs=0 
maxOccurs=nmbounded) and /myFavoriteWebSites/{any} (minOccurs=0 
maxOccurs=ambounded) fields provide for extensibility. 

The /myfavoriteWebSites/subscription (minOccurs=0 maxOccurs=unbounded) 
element defines a subscription node as described above in the subscription section. 
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mvlnbox 

The.NET Inbox service, generally referred to as mylnbox, is designed to store and 
manage e-mail related information for the associated identity. A primary purpose of the 
5 mylnbox service is to supply this information, on demand, to applications operating on the 
identity's behalf Using this service, an identity can manage e-mail from a variety of devices, 
and even manage multiple accounts from the same application. It is expected that this service 
will support some form of subscription, or pending query, so that applications or services can 
i-^ reliably cache information contained within the service. An example of this caching might be 
F:' 10 an e-mail application or service. For each folder and message in the store, a subscription is 
: J issued against this service for that item. If the item changes, the application can refresh itself 

Q This mylnbox service uses an XML schema to describe email, a user's email store, and 

the methods by which email is sent and received from the store. 

flJ 
□ 

Nf 15 mvlnbox / Roles 

The mylnbox service controls access by using the rtO, rt2 and rt99 roleTemplates, 
using the following scopes: 
scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 
20 <hs:shape base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfEIements 

25 <hs:scopeid=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs:shape base==nil> 
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<hs :include select=//* [@creator=' $callerld' ]/> 
<;/hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scopeid=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base=iiil> 
<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f.adcf-9fD7e5a5ec8£> 
<hs:shape base=ml> 
<hs:include selecW/* [cat/@ref='hs :public ' ]/> 
<hs:includeselect=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 



The mylnbox roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the mylnbox service through that method while mapped to this roleTemplate: 



TABLE - mylnbox roleTemplate rtO 



method 


scope/name 


Query 


allElements 


Lisert 


allElements 


Replace 


allElements 


Delete 


allElements ^ 


Update 


allElements : 


sendMessage 


allElements ^ 


saveMessage 


allElements \ 


copyMessage 


allElements \ 
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The mylnbox roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the mylnbox service through that method 
while mapped to this roleTemplate: 

TABLE - mylnbox roleTemplate rt2 



method 


scope/name ! 


Query 


allElements 


Insert 


onlySelfSubscriptionElements 


Replace 


onlySelfSubscriptionElements 


Delete 


onlySelfSubscriptionElements 


sendMessage 


allBlements 


saveMessage 


allElements 



The mylnbox roleTemplate rt99 blocks access to the content document. Note that lack 
of a role in the roleList has the same effect as assigning someone to rt99. 

mylnbox / Content 

The content document is an identity centric document, with its content md meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the mylnbox service: 
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in:myInbox changeNamb er= " . . . " instanceld-*..." 
xmlns:m="http://schemas.microsoftxom/hs/2001/10/^^ 
xmlns:hs="http://schemas.microsoftxom/hs/2001/10/core''>i..i 
<m:accottnt changeNuniber="...'' id="„." creator= *\..">i 
<m:name xml:lang="..." dir=="..,">i..i</m:name> 
<m;email> i t< /m:einail> 
<m;primarv> i i< /m:primarv > 
<m;cat ref=^\./>n nnhn,inHpH< /m;cat> 
<m:pop3 Settings>o.. i 
<m: server>i j </m: server> 
<m:userName>i..i</m:userName> 
<m:password>i..i</m:password> 
</m:pop3 Settings> 

</m:accouiit> 

<m:folder changeNamber= "..." id="..." creator= "..;>a 
<m;name xml:lang="..." dir="...">i .i</n|mam£> 
<m;tvpe> i i< /m:tvpe> 
<m;miread> n i< /m;unread> 
<m:parentFolderref="...''>o..i</m:parentFolder> 
<m;childFoIderComit> n i< /micliildFolderCount > 
fanvi 

</m:folder> 

<m:message changeNumber^ ".,." id="..." creator= "...''>n n.i ua 

<m:messageStatus ch^g^Jumber="...">i..i 
< in:isRead >i i< /m;isRead > 
<m:folder ref===".. ">i..,</m:folder> 
<m:flag>o..i 

< m;state >i i< /m;state> 

<m:title xmi:lang-"..." dir="...">i..i</m:title> 

<m:reminderDate>o..i</m:reminderDate> 

{any} 
</m:flag> 

<m;state> i i< /m:state> 
</m:messageStatus> 

<m:messageContent changeNmiiber= "„ ">i i 
<m:cat ref=" . . .">o „nhn»nHpri< /m; cat> 
<m:account ref="...">o..i</ni:account> 
<m:messageType>i„ i 

<m;tvpe> i i < /m;tvpe> 

<m:contentType>o..i</m:contentType> 

</m:messageType> 
<in;size> i i< /m;size> 
<m;importaiice> t i< /m:importance> 

<m:sensitivity>i„i</m:sensitivity> 
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<m:hasAttachments >i i< /m:hasAttachmeiits> 

<m:isJimkMail>Ka</m:isJunkMail> 

<m:containsAdultContent>i.,i</m:containsAdultContenP> 

<m;cQnversationId> n i < /m:conversatioiiId> 

<m:conversationlndex>o..i</m:conversationlndex> 

<m:dateReceived> M< /m;dateReceived> 

<m;dateSent> i i< /m;dateSeiit> 

<m:subject xml:lang="..." dir="...">i..i 

<m:prefix>i..i</m:prefix> 

< in;text> r t< /m:text > 
</m:subject> 
<m:from>i..i 

<m:name xml:lang="../' dir="...">i i< /in;name> 

<m;email> i i< /m:email> 
</m:from> 

<m:recipient type=="...">o..unboimded 

<ni:naine xnil:lang="„." dir="...">i..i</m:naTne> 

<m:email>i..i</Tn:email> 
</m:recipient> 

<m:plainBody>o..i</in:plainBody> 
<in:htnilBody>o.,i 
<Tn:body>i..i</m:body> 

<m:inlineAttachment>o..unbounded 

<in:uri>i..i</in:uri> 

<m:contentType>i..i</m:contentType> 

<m:content>i..i</in:content> 
</m:mIineAttachment> 
</m:htmlBody> 

<m:attachmenP*o..uribounded 

<in:naine>i..i</m:nanie> 

<in:ord>i..i</m:ord> 

<m:contentType>i 1 </m:contentType> 

<ni:content>i..i</in:content> 
</tn:attachinent> 

<m:messagePart id="...">o..unbounded 
<m:parentPartref-'..,">i..i</in:parentPart> 
<m:order>i..i</m:order> 
<m:contentType>i i</ni:contentType> 
<m:size>i..i</m:size> 

<m:contentDisposition>o.a</m:contentDisposition> 
<m:contentld>o..i</m:contentld> 
<m:contentLocation>o..i</m:contentLocation> 
<m;contentTransferEncoding>o..i</m:contentTransferEncoding> 
<m:partContent>o..i</m:partContent> 
</in:TnessagePart> 

<m:preview xnil:lang="..." dir="..,'>o..i</ni:preview> 
<m:single2822Header>o..unbounded</ni:single2822Header> 
<m:raw2822Content>o,i</m:raw2822Contcnt> 
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<m:raw2822Headers>o..i</m:raw2822Headers> 
{any} 

</m:messageContenf> 

</m:message> 

<m;draft changeNumber- id="..." creator='\..">o„unbounded 
<m:draftStatus changeNumber="...''>i.i 
<m;isRead >i i< /m:isRead > 
<m:folder ref="...">i..i</m:folder> 
<m:flag>a.i 

<m:state >i i < /m;state> 

<ni:title xmi:lang="..;' dir="...">i..i</m:title> 

<m:reminderDate>o..i</m:reininderDate> 

{any} 
</m:flag> 

<m;state> i i< /m;state> 
{any} 
</m:draftStatus> 

<m:draftContent changeNumber= ">«.">i i 
<m:cat ref=''..,">n .iiii.n.niH^< /m;cat> 
<m:account i;ef=",..">i..i</m:account> 
<m:draftType>i.i 

<m;tvpe> i \ < /m:tvpe> 

<m;contentTvpe> n i</ m:conteatTvpe> 

fany} 
</m:draftType> 
< iii: size> \ \ < /m : size> 
<m:importaiice> i ^</ m:importance> 
<iii:sensitivitv> i i< /m;sensitivitv> 
< m;hasAttachmeitts> i i</ m:hasAttachments> 
<m;conversationId> n i< /m:conversatioiiId> 
<m:conversationIndex> n i< /in;coiiversatioiiIndex> 
<m:subiect xml:lang=="..." dir="...">i..i 

<m:prefix>i..i</in:prefix> 

<m:text> i i< /m;text> 
< /m;sttbiect> 
<m:from>i..i 

<m;name xnil:lang=",.." dir=" ..">i..i</muiame> 
<iii;email> i i< /m;email> 

</m:froin> 

<m;recipient type=="...">o..unbounded 

<m:name xml:lang="..." dir="...">i..i</in:name> 

<mremail> i i< /m:email> 
< /m;recipient > 

<m:plainBodv >n i < /in;plamBodv> 
<m;htmlBodv >n t 
<m:body>i.,i</m:body> 
<m:iiilineAttachmeii t>n lln^^n»lnH^ 
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<m;uri> M< /m:uri> 

<iii;copteiitTYpp>, i< /m;coiitentTYp e> 
<m;content>t i< /m;content> 
< /in;mlineAttachment> 
< /m;htiiilBndy> 

<m5attachment>o unbounded 
<in;iiame> i i< /m:name> 
<ip;ord> i i< /m:ord> 
<m:coiitentTypio, i< /m;contentTyp fi> 
<m:content >i i< /m;content> 
< /m:attachinent> 
<m:draftPart changeNuniher=- 

<m:parentPart !:ef=".,.»>,..j</m:parentPart> 
<m;order> j j < /m;order > 
<m;conteiitTvpe>, t< /m;contentTYp e> 
<m;size> i i< /m:size> 

<m;contentDispn^ifinn>, ,< /m;contentDisp ositinii> 
<m;conteiitId >a j < /m:contentId > 
<in:contentT.ocatinn>^ , < /m:conteiitLocatinn > 

<m:contentTransfer Fnrodinr^ >o,< /m:contentTran.ferEncodm 
<m;partContent>, i< /m;DartCoiiteiit> 
fanv} 
</m:draftPart> 

<m:preview xnil:Iang="...» dir="..;'>o..,</m:preview> 
<m:single2822Header>o..unbounded</m:single2822Header> 
<m:raw2822Content>o..i</m:raw2822Content> 

<m:raw2822Headers>o..i</m:raw2822Headers> 
fanv} 

</in:draftContent> 
{any} 

<ym:draft> 

<m:rule sequence^". " changeNmnher= " » id="..." creator^" 

<m:namexml:lang="..;'dir="...">j.,i</m:name> 
<m;state >i t< /m;state> 

<m;rttnat> i i <m;rmiat > 

<m;runwhen>i i< /m:rmiwheii > 

<m:tvpe> i i< /m;tvpe > 

<m:provider xml:lang="..." dir=".. 



0.. unbounded 



.i</m:condition> 

1.. unbounded 



i< /m:provider> 



<m:condition select?=" 
<m:action sequence^".. 
<m:copyMessage>a.i 

<m:targetFolderselect="...">,.i</m:targetFolder> 

</m:copyMessage> 

<m:moveMessage>o.. i 

<m:targetFolder select="..,">i..i</m:targetFolder> 
</m:moveMessage> 

<m:deleteMessage>n i</m:deleteMessage> 
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<m:assignCategory>o..i 

< m;cat ref==^'\JW,mhn»r^.A</ m:c2ii> 
</in:assignCategory> 
<m: forwardMessage>o..i 
<m:recipient type="...">o„unboimded 
<m:name xinl:lang="..," dir="...">i..i</m:name> 
<m:email>i..i</m:email> 
</m:recipient> 
</in:forwardMessage> 
<m:forwardAsAttachment>o..i 
<in:recipient type-'.. ">o.,urf,oimded 
<m:naine xml:lang="..." dir=".. ">i..i</m:name> 
<m:eniail>i..i</in:email> 
</m:recipient> 
</in:forwardAsAttachment> 
<in:serverReply>o..i 
<in:subject xml:lang="..." dir="...">i..i 
<m:prefix>i . . i </m:prefix> 
<m:text>i..i</m:text> 
</m:subject> 

<m:sitnpleBody xinl:lang="..." dir="...">i..i</m:simpleBody> 
</m:serverReply> 
<m:redirectMessage>o..i 
<m:recipient type=",..">o..unboimded 
<m:name xml:lang="..." dir="...">i.,i</m:name> 
<m: email>i i</ni: email> 
</m:recipient> 
</m:redirectMessage> 
<m:flagMessage>o..i 
<m:flag>i..i 
<m:state>i..i</m:state> 
<m:title xml:lang="..;' dir=".,.">i..i</m:title> 
<m:reniinderDate>o..i</m:remmderDate> 
{any} 
</m:flag> 
</m:flagMessage> 

<m:markAsRead>o..i</tn:markAsRead> 

<m:stopProcessingRulesOfrhisType>o„i</m:stopProcessmgRulesOfrhisType> 
</m:action> 
fany} 
</m:ruIe> 

<]ii:subs€riptioii changeNumber= ",. " ' creator= '\»">n .mhn.,ndPH 
<hs:trigger select=".,/' mode-'..." baseChangeNumbcr="...''>i..i</hs:trigger> 
<hs:expiresAt>o..i</hs:expiresAt> 
<hs:context uri="...">i..i /a/iyy</hs:context> 
<hs:to>,..i</hs:to> 

</m;subscription> 
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{any} 

</m;myInbox> 

The meaning of the attributes and elements shown in the table are set forth below, 

wherein in the syntax used in the table, boldface type corresponds to a blue node, and 

underlined type to a red node, as described above, and the minimum occurrence mfonnation 

(0, 1) indicates whether an element or attribute is required or optional, and maximum 

occurrence information (1, unbounded) indicates whether one or many are possible. 

The /mylhbox (minOccurs=l mMOccurs=l) element represents the root element of 
myhibox. The /myhibox/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a particular service is provisioned for a user. 
The /mylnbox/account (minOccurs=l maxOccurs=unbounded) element represents a 
provisioned user's email account. This element can optionally contain POPS settings for 
myhibox services that support POPS aggregation. 

The /myhibox/account/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facihtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 
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The /myInbox/accoxmt/@id (minOccurs=l maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services 
generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myInbox/account/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. 

The /mylnbox/account/name (string minOccurs=l maxOccurs=l) field maintains the 
display name of the account. The /myInbox/accounl/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myInbox/account/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/account/email (string minOccurs=l maxOccurs==l) field maintains the 
SMTP email account. 

The /mylnbox/account/primary (boolean minOccurs=l maxOccurs=l) element defines 
this account as a primary or non-primary account. There can be only one primary account, 
and it can never be deleted. 
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The/myInbox/account/cat/@ref (anyURIminOccurs=l maxOccurs=l) attribute 
references a category definition (catDef) element using the rules outlined in the .NET 
Categories section (myCategories) described above. 

The /mylhbox/account/popSSettings (minOccurs=0 maxOccurs=l) defines pop3 
settings, if this account is a POPS account. Note that the primary account can not be a POPS 
account. The /myLibox/account/popSSettings/server (string minOccurs=l maxOccurs=l) 
field contains the name of the POPS server . The /mylnbox/account/popSSettings/userName 
(string minOccurs=l maxOccurs=l) contains the usemame of the POPS account. The 
/mylhbox/account/popSSettings/password (steing minOccurs=l maxOccurs=l) contains the 
password of the POPS account. 

Like other unbounded elements, multiple accounts may be set up, providing 
significantly functionaUty. For example, one node may maintain a user's primary email 
account, with another node set up as a secondary account. Even though email is received on 
one account, e.g., a POPS account, it can be sent out on the other, e.g., an ofBce email 
account. 

The /my]hbox/account/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

Folders represent the unit of containment for the mylnbox service. The 
/myhibox/folder (minOccurs=4 maxOccurs=unbounded) folder element in mylnbox are 
containers for messages, although not directly. Messages are related to folders via the 
/myhibox/message/messageStatus/folder ref^'*" attribute. Folders can be organized 
hierarchically, although again not directly. Instead, folder containment is modeled using the 
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/mylnbox/folder/parentFolder ref = attribute. If a folder is deleted, all associated messages, 
folders and their messages are deleted. It is recommended that instead of deleting a folder 
directly, it should be moved to the type="deleted" folder first. There are four buih in types of 
folders, and these can be identified by four special type element values: /folder/type = *inbox' 
5 is the hibox folder, /folder/type = 'sent' is the Sent Items folder, /folder/type = 'drafts' is the 
Drafts folder, /folder/type = 'deleted' is the Deleted Items folder. These four special folders 
will always exist in a provisioned .NET Libox account, and cannot be deleted or modified. To 
create user defined folders, the standard .NET My Services insert method can be used, with 
the type set to 'custom'. Custom (user-defined) folders can be created, deleted or modified, 
Q 10 and virtual hierarchies can be established via the parent folder attribute. 
^'4 The /myInbox/folder/@changeNumber (minOccurs=l maxOccurs=l ) changeNumber 

j;^ attribute is designed to facilitate caching of the element and its descendants. This attribute is 
i ^ assigned to this element by the .NET My Services system. The attribute is read only to 
1 Ij applications. Attempts to write this attribute are silently ignored. 

Q 15 The /myInbox/folder/@id (minOccurs=l maxOcciirs=l) attribute is a globally unique 

|; sis 

ID assigned to this element by .NET My Services. Normally, .NET My Services generates 
and assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. After an ID has been assigned, the attribute is read only and attempts 
20 to write it are silently ignored. 

The /mylnbox/folder/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. The /mylnbox/folder/name 
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(string minOccurs=l maxOcciirs=l) element contains the name of the e-mail folder. For the 
four special folders, this element is read only. For custom folders, this element can be edited. 
The /myInbox/folder/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this atbibute indicates the language type of the content within this 
element The /mylnbox/folder/name/@dir (string minOccurs=0 maxOccurs-1) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left) and Itr (left to right). 

The /mylnbox/folder/type (string minOccurs=l maxOccurs=l) element contains a type 
identifier for this folder, and will contain the value 'inbox, 'sent', 'drafts' or 'delete' for the 
four special folders. For otiier folders, this value will be 'custom'. 

The /mylnbox/folder/unread (unsignedLong minOccurs=0 maxOccurs=l) contains the 
calculated count of the unread messages associated with this folder. This element is read 
only. The /mylnbox/folder/parentFolder (minOccurs=0 maxOccurs=l) element contains a ref 
attribute that specifies the ID of the parent folder. For top-level folders, this attribute = "". 
This attribute cannot be set on the four special folders, as tfiey remain top level folders. 

The /myhibox/folder/parentFolder/@ref (minOccurs=0 maxOccurs=l) contains a 
uuidType used to specify a universally unique identifier (UUDD), 

The /myLibox/folder/childFolderCount (unsignedLong minOccursK) maxOccurs=l) 
attribute is calculated by the service, and indicates how many subfolders that folder contains. 
Note that fields can be calculated rather than stored or changed by the user. For example, a 
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calculated field is used to maintain information such as how many items are in a folder since 
this number is not something a user directly decides, but rather results from other information. 

The /myhibox/folder/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 

The /mylnbox/message (minOccurs=0 maxOccurs=unbounded) element defines a 
single message in mylnbox in the base schema. A message represents an email message, and 
is divided into two sub-groups 'messageStatus' and 'messageContent'. This field is for 
received and sent messages, (not for drafts). 

The /myInbox/message/@changeNumber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to faciUtate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The/my]nbox/message/@id (minOccurs=l maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services 
generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest, Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The /myInbox/message/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformld of the node. The 

/mylnbox/message/messageStatus (minOccurs=l maxOccurs=l) element defines the status of 



-271- 



the email, and frequently changes. Caching cUents should take advantage of this when 
deciding which part of the message to change. 

The /myInbox/message/messageStatus/@changeNumber (minOccurs=l 
maxOccurs=l) changeNxmiber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to appUcations. Attempts to write this attribute are silently ignored. 

Certain email-related elements frequently change. If a user wants to synchronize on 
each chaage, a great deal of information would need to be exchanged, even though most 
changes are sunple changes in message status, rather than content, such as from unread to 
read. Status information is thus maintained separately. The 

/mylnbox/message/messageStatus/isRead (boolean minOccurs=l maxOccurs=l) element 
defines the read/unread state of the message, and can be modified. The 
/myLibox/message/messageStatus/folder (minOccurs=l maxOccurs=l) element defines the 
single folder to which this message logically belongs. The 

/myInbox/message/messageStatus/folder/@ref (minOccurs=0 maxOccurs=l) uuidType is 
used to specify a universally xmique identifier (UUID). 

The /mylnbox/message/messageStatus/flag (minOccurs=0 maxOccurs=l) optional 
element defines the flag state of the message. It includes an {any} element that can be used 
for extensible flags. The /mylnbox/message/messageStatus/flag/state (string minOccurs=l 
maxOccurs=l) field maintains state of a message flag. The 

/mylnbox/message/messageStatus/flag/title (string minOccurs=l maxOccurs=l) field 
maintains the client-defined text of the flag. The 
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1. J 



/myInbox/message/messageStatus/flag/title/@xml:lang (minOcciirs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 1 66 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/message/messageStatus/flag/title/@dir (string 
5 minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/message/messageStatus/flag/reminderDate (dateTime minOccurs=0 
maxOccurs=l) field maintains the cUent-defined reminder date of the flag. The 
/myInbox/message/messageStatus/flag/{any} (minOccurs=0 maxOccurs=unbounded) field 
1 0 allows for extensibility. 

The /mylnbox/message/messageStatus/state (string minOccurs=l maxOccurs=l) 
element defines the sent/received state of the message. This element is read only, which 
means that it can be queried for, but not updated. The 

/myInbox/message/messageStatus/{any} (minOccurs=0 maxOccurs=unboimded) field allows 



3 1 5 for extensibility. 

The /mylhbox/message/messageContent (minOccurs=l maxOccurs=l) element 
defines the content of the message. This data changes rarely in a normal apphcation. 

The /myInbox/message/messageContent/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
20 descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to apphcations. Attempts to write this attribute are silently ignored. 
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The /mylnbox/message/messageContent/cat (rQinOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing either a global 
category definition (in either the .NET Categories service system docxxment or an extemal 
resource containing category definitions), or by referencing an identity-centered category 
5 definition in the content document of the .NET Categories service for a particular PUID. 
The /myInbox/message/messageContent/cat/@ref (anyURI minOccvirs=l 
maxOccurs=l) attribute references a category definition (catDef) element using the rules 
outlined in the .NET Categories section (myCategories) described above. 

The /mylnbox/message/messageContent/account (minOccurs=0 maxOccurs=l) 
Q 10 element contains a reference to the /mylnbox/account element to which this message was sent. 
''4 The /myInbox/message/messageContent/account/@ref (minOccurs=0 maxOccurs=l) 

Kj « 

I:;! uuidType is used to specify a universally unique identifier (UUID). 

I J, The /mylnbox/message/messageContent/messageType (minOccurs=l maxOccurs=l) 

i y subelements of this element describe the contents of the message. 

1 3 1 5 The /mylnbox/message/messageContent/messageType/type (string minOccurs=l 

maxOccurs=l) element contains a value that provides the client vidth enough information to 
render an *Inbox' view of the messages. Valid values include 'voice', 'subscription', 'fax', 
'dsn*, 'readReceipt', 'meetingResponse', 'meetingRequest', 'email' or 'liveEmail'. 
The /mylnbox/message/messageContent/messageType/contentType (string 
20 minOccurs=0 maxOccurs=l) field maintains the contentType of the message (in accordance 
with RFC 2045). Examples of this are: 'text/plain' ^d 'multipart/mime'. 
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The /myInbox/message/messageContent/messageType/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibility. 

The /mylnbox/message/messageContent/size (unsignedLong ininOccurs=l 
maxOccurs=l) element contains the size, m bytes, of the entire RFC2822 message in the 
store. 

The /mylnbox/message/messageContent/importance (string minOcciirs==l 
maxOccurs=l) element indicates the importance of this message. Valid values include *low', 
^normal', or 'high'. The default is 'nortnar. 

The /mylnbox/message/messageContent/sensitivity (string minOccurs=l 
maxOccurs=l) element indicates the sensitivity of the message. Valid values include 
*normar, 'personal', 'private', or 'confidential'. 

The /mylnbox/message/messageContent/hasAttachments (boolean minOccurs=l 
maxOccurs=l) element indicates whether a message has one or more attachments. The value 
will either be 0 (to indicate that the message has no attachments) or 1 (to indicate that the 
message has one or more attachments). 

The /mylnbox/message/messageContent/isJunkMail (boolean minOccurs=l 
maxOccurs=l) element is read only and is set by the myhibox service when the message was 
delivered, and indicates if the message was marked as junk mail by the junk mail filter. 

The /myLabox/message/messageContent/containsAdultContent (boolean minOccurs=l 
maxOccurs=l) read-only element is set by the myltibox service when the message was 
deh vered and indicates if the message was determined to contain adult content by the aduh 
content mail filter. 
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The /mylnbox/message/messageContent/conversationld (string minOccurs=0 
maxOccurs=l) optional element identifies the ^conversation,' or e-mail thread of which this 
message is a part. 

The /mylnbox/message/messageContent/conversationlndex (string minOccurs=0 
maxOcciirs=l) optional element identifies the 'conversation,' or e-mail thread of which this 
message is a part. 

The /mylnbox/message/messageContent/dateReceived (dateTime minOccurs=l 
maxOccurs=l) read-only element contains the UTC date/time the message was received, and 
appears in all messages except ones that were sent by the user. 

The /mylnbox/message/messageContent/dateSent (dateTime minOcciirs=l 
maxOccurs=l) read-only element contains the UTC date/time the message was sent. For 
/message/messageStatus/state="sent" messages, this element represents the time the message 
was sent. For /message/messageStatus/state="received" this element represents the time the 
sender sent the message. 

The /mylnbox/message/messageContent/subject (minOccurs=l maxOccurs=l) 
element contains the subject of the message. This element contains both a prefix and text sub- 
elements, to allow clients to sort on the non-prefix part of the subject (e.g., so RE: RE: doesn't 
get sorted). The /mylhbox/message/messageContent/subject/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myhibox/message/messageContent/subject/@dir 
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(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myLibox/message/messageContent/subject/prefix (string minOccurs=l 
maxOccurs=l) contains the prefix of a message subject, (e.g., TW:'), 
5 The /mylnbox/message/messageContent/subject/text (string minOccurs=l 

maxOccurs=l) contains the subject of a message minus the prefix (e.g., 'hello there'). 

The /mylnbox/message/messageContent/fi'om (minOccurs=l maxOccurs=l) is a read- 
only element that describes who this message is from. 
I J The /mylnbox/message/messageContent/from/name (string minOccurs=l 

Q 10 maxOccurs=l) field includes the display name of an e-mail address. The 
''4 /myhibox/message/messageContent/fi"om/name/@xml:lang (niinOccurs=l maxOccurs=l) 

reqiured attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
I y within this element. The /myInbox/message/messageContent/fix>ni/n^ (string 

j' H s 

Q 1 5 minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. VaUd values are rtl (right to left) and Itr (left to right). 

The /mylnbox/message/messageContent/firom/email (string minOccurs=l 
maxOccurs=l) field maintains an e-mail address (for example, someone@microsoft.com). 
The /mylnbox/message/messageContent/recipient (minOccurs=0 
20 maxOccurs=unbounded) field specifies the recipient of this message and where they appear, 
A collection of recipient elements is only returned if the query option 'expandRecipients' is 
specified. 
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The /myInbox/message/messageContent/recipient/@type (string minOccurs=l 



maxOcciirs=l) field specifies whether the recipient is in the *to' or 'cc' list. 



The /mylnbox/message/messageContent/recipient/name (string minOccurs=l 



maxOccurs=l) stores the display name of the recipient's e-mail address. The 



5 /myInbox/message/messageContent/recipient/name/@xml:lang (minOcciirs=l maxOccurs= 1 ) 



required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 



described in RFC 1766. The value of this attribute indicates the language type of the content 



within this element. The /myInbox/message/messageContent/recipient/name/@dir (string 



minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 

I. '3 

Q 10 localized string. Valid values are rtl (right to left) and Itr (left to right). 



\J The /mylnbox/message/messageContent/recipient/email (string minOccurs=l 

•;2 maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 



The /mylnbox/message/messageContent/plainBody (string minOccurs=0 

1:3 

maxOccurs==l) field contains the plain body representation of the message. This element is 



Q 15 returned by passing the *includeSimpleMessageView' element in query options. 



The /mylnbox/message/messageContent/htmlBody (minOccurs=0 maxOccurs=l) field 



contains the html body representation of the message. This element can also contain inline 



attachments that are related to the html content via the 'uri' element of the inline attachment. 



This element is retumed by passing the 'includeSimpleMessageView' element in query 



20 options. The /mylnbox/message/messageContent/htmlBody/body (string minOccurs=l 



maxOccurs=l) field contains the contents of the body. 
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The /mylnbox/message/messageConteniyhtmlBody/inlineAttachm (minOccurs=0 
maxOccurs=iinbounded) element represents an inline attachment The 
/mylnbox/message/messageContent/htmlBody/inlineAttachment/uri (string minOccurs=l 
maxOccurs==l) field contains the client-defined unique identifier for the inline attachment. 
This element is used to identify this attachment location within the html body of a message. 

The/myLibox/message/messageContent/htmlBody/inlineAttachment/contentType 
(string minOccurs=l maxOccurs=l) field contains the Content-Type of the attachment. 

The /mylnbox/message/messageContent/htmlBody/inlineAttachment/content 
(base64Binary minOccurs=l maxOccurs=l) field contains the base64 encoded attachment 
content. 

The /mylnbox/message/messageContent/attachment (minOccurs==0 
maxOccurs=unbounded) element represents a mail attachment and is retumed by passing the 
*includeSimpleMessageViewAttachments' element in query options. 

The /mylnbox/message/messageContent/attachment/name (string minOccurs=l 
maxOccurs=l) field contains the chent defined name of the attachment. 

The /mylnbox/message/messageContent/attachment/ord (xmsignedLong minOccurs=l 
maxOccurs=l) field contains the unique order that this attachment should appear relative to 
all other attachments. 

The /mylnbox/message/messageContent/attachment/contentType (string minOccurs=l 
maxOccurs=l) field contains the Content-Type of the attachment. 

The /myhibox/message/messageContent/attachment/content (base64Binary 
minOccurs=l maxOccurs=l) field contains the base64 encoded attachment content. 
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The /mylnbox/message/messageContent/messagePart (minOccurs=0 
maxOcciirs=unbomided) field contains the element and its children define the message 
stracture (including the contents). This element is retumed by passing the 
'includeMessagePartStructure' element in query options. 

The /myInbox/message/messageContent/messagePart/@id (minOccurs=l 
maxOccurs=l) field contains the unique identifier of the messagePart. The 
/mylnbox/message/messageContent/messagePart/parentPart (minOccurs=l maxOccurs=l) 
element points to the parent part of this part. The 

/myInbox/message/messageContent/messagePart/parentPart/@ref (minOccurs=0 
maxOccurs=l) uuidType is used to specify a universally unique identifier (UUID). 

The /mylnbox/message/messageContent/messagePart/order (unsignedLong 
minOccurs=l maxOccurs=l) element defmes the order of this part relative to its siblings. The 
/mylnbox/message/messageContent/messagePart/contentType (string minOccurs=l 
maxOccurs=l) element defines the contentType of the part, (for example, message/rfc or 
text/plain.a). 

The /myhibox/message/messageContent/messagePart/size (unsignedLong 
minOccurs=l maxOccurs=l) field contains the size in bytes of the message part (including 
mime headers). The /mylnbox/message/messageContent/messagePart/contentDisposition 
(string minOccurs=0 maxOccurs=l) element defines the content-disposition of the part, e.g., 
attachment; filename-'txtl.txt". 

The /myhibox/message/messageContent/messagePart/contentld (string nainOccurs=0 
maxOccurs=l) element defmes the content-id of the part. 
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The /mylnbox/message/messageContent/messagePart/contentLocation (string 
minOccurs=0 maxOccurs=l) element defines the content-location of the part. 

The /niylnbox/niessage/niessageContent/niessagePart/contentTransferEncoding (string 
minOccurs=0 maxOccurs=l) element defines the content-transfer-encoding of this part. 
5 The /mylnbox/message/messageContent/messagePart/partContent (base64Binaty 

minOccurs=0 maxOcciirs=l) elements contains the content of this message part and is only 
retumed by including the *includePartContent' element in the query options. 

The /mylnbox/message/messageContent/preview (string minOccurs=0 maxOccurs=l) 
, ^ field contains the first 256 characters of the message body. This element is only returned if 

':' ""s 

10 the query option *includePreview' is specified, to allow clients to selectively implement a 

\| preview-like message fimction or not, e.g., thin clients may not want to download an entire 

::| message just for a quick view. The /myInbox/message/messageContent/preview/@xml:lang 

l^^ (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

j y or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 

j lit? . 

Q 15 the language type of the content within this element. The 

U 

/myInbox/message/messageContent/preview/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
are rtl (right to left) and Itr (left to right). 

At times it may be desirable to a client to only obtain metadata about a message rather 
20 than downloading the message. The /myIiibox/message/messageContent/single2822Header 
(string minOccurs=0 maxOccurs=unbounded) field contains the rfc2822 headers not included 
in the base schema (e.g., x-apparently-to). This element is retumed by passing the 
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'includeSingle2822Headers' element in query options. The 
/myInbox/message/messageContent/raw2822Content (base64Binary niinOccurs=0 
maxOccurs=l) field contains the raw 2822 message (including headers and body) This 
element is returned by passing the includeRaw2822Contentelement in query options. The 
5 /myInbox/message/messageContent/raw2822Headers (base64Binary minOccurs=0 

maxOccurs=l) field contains the raw rfc2822 headers not included in the base schema (e.g., x- 
apparently-to). This element is returned by passing the *includeRaw2822Headers' element in 
query options. 

1 ^ The /myhibox/message/messageContent/ {any} (niinOccurs=0 

I ^ 10 maxOccurs=unbounded) field allows for extensibility. 

A draft is a message that has not been sent. A draft node is defined that is similar in 

0 many ways to that of a regular message node. However, certain things about a draft message 
; ^ are different from received or sent messages, such as that they may be edited, do not have a 

1 y date sent or date received time. The shape of a draft message is different, as well, and draft 
ui 15 messages are likely to change, and thus the draft schema includes many red nodes. 

In traditional email applications a draft message is stored in a Drafts folder and later 
sent. .NET Inbox allows for a draft to be stored in any folder. To this end, the /mylnbox/draft 
(minOccurs=0 maxOccurs=nmbounded) element defines a single draft in mylnbox in the base 
schema. A draft represents an unsent email and is divided into two sub-groups 
20 'messageStatus' and 'messageContent'. The /myInbox/draft/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
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descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /myhibox/draft/@id (minOccurs=l maxOccurs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services generates 
and assigns this ID during an insertRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. After an ID has been assigned, the attribute is read only and attempts 
to write it are silently ignored. 

The /myInbox/draft/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platfonnld of the node. 

The /mylnbox/draft/draftStatus (minOccurs=l maxOccurs=l) field contains the 
contents of this element represent the status metadata of the draft. 

The /myInbox/draft/draftStatus/@changeNumber (minOccurs^l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read only to applications. Attempts to write this attribute are silently ignored. 

The /mylnbox/draft/draftStatus/isRead (boolean minOccurs=l maxOccurs=l) element 
defines the read/unread state of the message and can be modified. 

The /mylnbox/draft/draftStatus/folder (niinOccurs=l maxOccurs=l) element defines 
the single folder that this message logically belongs to. For drafts this may point to the drafts 
folder, but also may point to another folder, enabhng drafts to be stored in another folder. 
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The /myInbox/draft/draftStatus/folder/@ref (niinOccurs=0 maxOccurs=l) uuidType is 
used to specify a universally unique identifier (UUID). 

The /mylnbox/draft/draftStatus/flag (minOccurs=0 maxOccurs=l) optional element 
defines the flag state of the message. It includes an {any} element that can be used for 
extensible flags. 

The /mylnbox/draft/draflStatus/flag/state (string minOccurs=l maxOccurs=l) field 
contains the state of a message flag. 

The /mylnbox/drafl/draftStatus/flag/title (string niinOccurs=l maxOccurs=l) field 
contains the client defined text of the flag. The 

/mylnbox/drafl/draftStatus/flag/title/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draft/draftStatus/flag/title/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Vahd values are rtl (right to left) and Itr (left to right). 

The /mylnbox/drafl/draftStatus/flag/remmderDate (dateTime minOccurs=0 
maxOccurs=l) field contains the client defined reminder date of the flag. The 
/myInbox/draft/draflStatus/flag/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. The /mylnbox/draft/draflStatus/state (string niinOccurs=l maxOccurs=l) is an 
element, the value of which is 'draft'. It is provided for compatibility with messages. The 
/myInbox/draft/draftStatus/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibility. 
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The /mylnbox/draft/draflContent (minOccurs=l inaxOccurs=l) element includes the 
contents that represent the content of the draft. The 

/mylnbox/draft/draftContent/@changeNimiber (niinOccurs==l maxOccurs=l) changeNumber 

attribute is designed to facilitate caching of the element and its descendants. This attribute is 
5 assigned to this element by the .NET My Services system. The attribute is read only to 

applications. Attempts to write this attribute are silently ignored. 

The /mylnbox/draft/draftContent/cat (minOccurs=0 maxOccurs=unbounded) element 

is used to categorize the element that contains it by referencing either a global category 

definition (in either the .NET Categories service system document or an extemal resource 
1 0 containing category definitions), or by referencing an identity-centered category definition in 

the content document of the .NET Categories service for a particular PUID. 

The /myInbox/draft/draftContent/cat/@ref (anyURI minOccurs=l ma5cOccurs=l) 

attribute references a category definition (catDef) element using the rules outlined in the .NET 

Categories section (myCategories) described above. 
1 5 The /myhibox/draft/draftContent/account (minOccurs=l maxOccurs=l) element 

contains a reference to the /mylhbox/account element ref fi-om which this message should be 

sent. 

The /myInbox/draft/draftContent/account/@ref (minOccurs=0 maxOccurs=l) 
uuidType is used to specify a universally imique identifier (UUID). 
20 The /mylnbox/draft/draftContent/draftType (minOccurs=l maxOccurs=l) element 

includes subelements that describe the contents of the message. The 
/mylnbox/draft/draftContent/draftType/type (string minOccurs=l maxOccurs=l) element 
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contains a value that provides the client with enough information to render an 'Libox' view of 
the messages. Valid values are *voice\ 'subscription', *fax', *dsn% 'readReceipt', 
'meetingResponse', 'meetingRequest', 'email' or 'liveEmail'. The 

Zmylnbox/draft/draftContent/draftType/contentType (string minOccurs=0 maxOccurs=l) field 
5 contains the contentType of the message (in accordance with RFC 2045), Examples of this 
are: 'text/plain' and 'multipart/mime'. 

The /myInbox/draft/draftContent/draftType/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibiUty. 
J , The /mylnbox/draft/draftContent/size (unsignedLong minOccurs=l maxOccurs=l) 

i. - J 

i; fi 10 read only element contains the size, in bytes, of the entire RFC2822 message in the store. 
H The /mylnbbx/drafl/draftContent/importance (string minOccurs=l maxOccurs=l) 

m 

*:3 element indicates the importance of this message. Valid values include 'low', 'normal', or 

'high'. The default is 'normal'. 
I y The /myTnbox/draft/draftContent/sensitivity (string minOccurs=l maxOccurs=l) 

i; 3 15 element indicates the sensitivity of the message. Vahd values include 'normal', 'personal', 

j! 

'private', or 'confidential'. 

The /mylnbox/draft/draftContent/hasAttachments (boolean minOccurs=l 
maxOccurs=l) read only element indicates whether a message has one or more attachments. 
The value will either be 0 (to indicate that the message has no attachments) or 1 (to indicate 
20 that the message has one or more attachments). 

The /mylnbox/draft/draftContent/conversationld (string minOccurs=0 maxOccurs=l) 
optional element identifies the 'conversation,' or e-mail thread of which this message is a part. 
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The /mylnbox/draft/draftContent/conversationlndex (string minOccurs=0 
maxOcciirs=l) optional element identifies the 'conversation,' or e-mail thread of which this 
message is a part. 

The /mylnbox/draft/draftContent/subject (minOccurs=l maxOccurs=l) field contains 
5 the subject of the message. This element contains both a prefix and text sub-elements to 

allow clients to sort on the non-prefix part of the subject (so RE: RE: doesn't get sorted). The 
/myInbox/draft/draftContent/subject/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
i;3 10 within this element. The /myInbox/draft/draftContent/subject/@dir (string minOccurs=0 
%f maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
;;| Valid values are rtl (right to left), and Itr (left to right). 

The /mylnbox/draflt/draftContent/subject/prefix (string minOccurs=l maxOccurs=l) 

Q 

I U field contains the prefix of a message subject (e.g., TW:'). 

p 15 The /niylnbox/drafl^ftContent/subject/text (string minOccurs=l maxOccurs=l) 

field contains the subject of a message minus the prefix (e.g., *hello there'). 

The /mylnbox/draft/draftContent/from (minOccurs=l maxOccurs=l) read-only 
element describes who this message is from. To set this value, set the account element. 

The /mylnbox/draflydraftContent/from/name (string minOccurs=l maxOccurs=l) field 
20 contains the display name of an e-mail address. The 

/myInbox/drafl/draftContent/from/name/@xml:lang (minOccurs=l maxOccurs=l) requu-ed 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
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described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/drafl/draftContent/from/name/@dir (string minOccurs=0 
naaxOccurs=l) optional attribute specifies the default layout direction for the locahzed string. 
Valid values are rtl (right to left) and Itr (left to right). 
5 The /mylnbox/draft/draftContent/froni/email (string minOccurs=l maxOccurs=l) field 

contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/draft/draftContent/recipient (minOccurs=0 maxOccurs=unbounded) 
field specifies the recipient of this message and where they appear. 
: , The /myInbox/draft/draftContent/recipient/@type (string minOccurs=l maxOccurs=l) 

:•' ^ 

j 5 10 field specifies whether the recipient is in the *to', *cc' or 'bcc' list. 

' 4 The Anylnbox/draft/draftContent/recipient/name (string minOccurs=l maxOccurs=l) 

field contains the display name of an e-mail address. The 

Q 

/myInbox/draft/draftContent/recipient/name/@xml:lang (minOccurs=l maxOccurs=l) 
i y required attribute is used to specify an ISO 639 language code or an ISO 3 166 coimtry code as 
1:3 15 described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/draflydraftContent/recipient/name/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/drafl/draftContent/recipient/email (string minOccurs=l maxOccurs=l) 
20 field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/draft/draftContent/plainBody (string mmOccurs=0 maxOccurs=l) field 
contains the plain body representation of the draft. The 
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/mylnbox/draft/draftContent/htmlBody (minOccurs=0 maxOccurs=l) field contains the html 

body representation of the draft. This element can optionally contain inline attachments. The 

/myInbox/d^aft/draftContent/htmlBody^ody (string minOccurs=l maxOccurs=l) field 

contains the contents of the body. The 
5 /mylnbox/draft/draftContent/htmlBody/inhneAttachment (minOcciirs=0 

maxOccurs=imboiinded) element represents an inline attachment. 

The /mylnbox/draft/draftContent/htmlBody/inlineAttachment/uri (string minOccurs=l 

maxOccurs=l) field contains the client-defined unique identifier for the inUne attachment. 
I ^ This element is used to identify this attachment location within the html body of a message. 
i;3 10 The /niylnbox/draft/draftContent/htmlBody/inhneAttac^ (string 

Si minOccurs=l maxOccurs=l) field contains the Content-Type of the attachment. The 

/mylnbox/drafl/draftContent/htmlBody/inlineAttachment/content (base64Binary minOccurs=l 

3 S 

maxOccurs=l) field contains the base64 encoded attachment content. The 

i Ij /mylnbox/draft/draftContent/attachment (minOccurs=0 maxOccurs=unbounded) element 

i y 

Q 15 represents a mail attachment. 

jisl? 

The /mylnbox/drafl/draftContent/attachment/name (string minOccurs=l 
maxOccurs=l) field contains the client defined name of the attachment. The 
/mylnbox/draflt/draftContent/attachment/ord (unsignedLong minOccurs=l maxOccurs=l) 
specifies the unique order that this attachment should appear relative to all other attachments. 
20 The /mylnbox/draft/draftContent/attachment/contentType (string minOccurs=l maxOccurs=l) 
provides he Content-Type of the attachment. 



-289- 



The /mylnbox/drafl/draftContent/attachment/content (base64Binary minOccurs=l 
maxOcciirs=l) comprises the base64 encoded attachment content. The 
/myhibox/draft/draftContent/draftPart (mmOccurs=l maxOccurs=unbounded) element and its 
children define the message stracture (including the mime body). 

The /myInbox/draft/draftContent/draflPart/@changeNumber (minOccurs=l 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read only to applications. Attempts to write this attribute are silently ignored. 

The /mylhbox/draft/draflContent/draflPart/parentPart (minOccurs=l maxOccurs=l) 
element points to the parent part of this part. The 

/myInbox/draft/draftContent/drafiPart/parentPart/@ref(minOccurs=0maxOccurs=l) 
uuidType is used to specify a universally unique identifier (UUID). 

The /myhibox/draft/drafl;Content/draftPart/order (unsignedLong minOccurs=l 
maxOccurs=l) element defines the order of this part relative to its siblings. The 
/myhibox/draft/draftContent/draftPart/contentType (string minOccurs=l maxOccurs=l) 
element defines the contentType of the part, (e.g., message/rfc or text/plain.a). 

The /myhibox/drafl/draftContent/draftPart/size (unsignedLong minOccurs=l 
maxOccurs=l) field contains the size in bytes of the message part (including mime headers). 
The /mylnbox/draft/draftContent/draflPart/contentDisposition (string minOccurs=0 
maxOccurs=l) field contains the element defmes the content-disposition of the part ex: 
attachment; filename='txtl.txt". The /mylnbox/draft/draftContent/draftPart/contentld (string 
minOccurs=0 maxOccurs=l) element defines the content-id of the part. The 
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/mylnbox/draft/draftContent/draftPart/contentLocation (string minOcciirs=0 maxOccurs=l) 
element defines the content-location of the part. 

The Zmylnbox/draft/draftContent/draftPart/contentTransferEncoding (string 
minOcciirs=0 maxOccurs=l) element defines the content-transfer-encoding of this part. The 
5 /mylnbox/draft/draftContent/draflPart/partContent (base64Binary minOcciirs=l 
maxOccurs=l) elements contain the content of this message part. The 
/myInbox/draft/draftContent/draftPart/{any} (minOccurs=0 maxOccurs=unboiinded) field 
allows for extensibility. 

ij, The /myMbox/draft/draftContent/preview (string minOcciirs=0 maxOccurs=l) field 

i;3 10 contains the first 256 characters ofthe message body. This element is only returned if the 
12 query option 'includePreview' is specified. The 

/myInbox/draft/draftContent/preview/@xml:lang (minOccurs=l maxOccurs=l) required 
I A attribute is used to specify an ISO 639 language code or an ISO 3 1 66 country code as 
i 11 described in RFC 1766. The value of this attribute indicates the language type ofthe content 
P 15 within this elenaent. The /myInbox/draft/draftContent/preview/@dir (string minOccurs=0 

j! sis 

maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /myInbox/draft/draftContent/single2822Header (string minOccurs=0 
maxOccurs=ambounded) field contains the rfc2822 headers not included in the base schema 
20 (e.g., x-apparently-to). This element is returned by passing the HncludeSingle2822Headers' 
element in query options. 
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The /myInbox/draft/draftContent/raw2822Content (base64Binary ininOccurs=0 
maxOccurs=l) field contains the raw 2822 message (including headers and body) This 
element is returned by passing the includeRaw2822Contentelement in query options. The 
/myInbox/drafl/draftContent/raw2822Headers (base64Binary minOccurs=0 maxOccurs=l) 
field contains the raw rfc2822 headers not included in the base schema (e.g., x-apparently-to). 
This element is retumed by passing the *includeRaw2822Headers' element in query options. 
The /myInbox/draft/draftContent/{any} (minOccurs=0 maxOccurs=unbounded) and the 
/myLibox/draft/{any} (minOccurs=0 maxOccurs=unbounded) fields allow for extensibihty. 

The /mylnbox/rule (minOccurs=0 maxOccurs=unbounded) field contains rules that 
specify actions that should be performed on the active message during sending or delivery. 
For example, certain messages may be moved to a particular folder via a rule, while out-of- 
office is also implemented via rule. The /mylnbox/mle/@sequence (unsignedLong 
minOccurs=l maxOccurs=l) required attribute specifies the order in which this action should 
be performed, relative to other actions for this rule. 

Most email applications allow for rules, however rules expressed by one email 
application normally cannot be consumed by another application, forcing each client to invent 
a new storage mechanism. Li .NET Libox there is a single schema for how a rule is stored. 
For example, the sample schema table below would move new messages with the importance 
set to high to the Important mail folder: 
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<myInbox> 

<folderid="123> 

<name xinl:lang="en">Iinportant</name> 

</folder> 
<rule> 

<name xml:lang="en">Move high priority email to Important folder</name> 

<enabled>True</enabled> 

<runat>server</runat> 

<condition 

select="./inq)ortance = 'high"^ 
</condition> 
<action> 

<moveMessage> 

<targetFolder ref="123"/> 

</moveMessage> 
</action> 

</rule> 

</myInbox> 



Expressing this rule structure in XML allows all clients to know what the rules are and 
which are run by the server and which by the client. 

The /myInbox/mle/@changeNumber (minOccurs==l maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
applications. Attempts to write this attribute are silently ignored. 

The /myInbox/rule/@id (minOccurs=l maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services generates and 
assigns this ID during an inserfRequest operation or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. After an ID has been assigned, the attribute is read only and attempts 
to write it are silently ignored. 
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The /myInbox/rule/@creator (minOcciirs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. The /myhibox/rule/name (string 
minOccurs=l maxOccurs=l) field contains the application-defined, human readable identifier 
of the rule. The /myInbox/rule/name/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myhabox/rule/name/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
are rtl (right to left) and Itr (left to right). 

The /mylnbox/rule/state (string minOccurs=l maxOccurs==l) field indicates whether 
the rule represented by this node is currently enabled. The /mylnbox/rule/runat (string 
minOccurs=l maxOccurs=l) required attribute specifies where the rule must run. For 
example, rules may be run at a server, wherein the value is ^server', or may be run at a client. 

The /mylnbox/rule/runwhen (string minOccurs=l maxOccurs=l) required attribute 
specifies when the rule must run. Allowable values include 'sending' and 'receiving'. 

The /mylnbox/rule/type (string minOccurs=l maxOccurs=l) field specifies if this is of 
type 'oof or 'normal'. 

The /mylnbox/rule/provider (string minOccurs=l maxOccurs==l) field contains the 
appUcation-defined provider of the rule. This is provided so that multiple appUcations can (if 
they so desire) only alter their own rules. The /myInbox/rule/provider/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
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the language type of the content within this element. The /myLibox/rule/provider/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/rule/condition (minOccurs=l maxOccurs=l) element's select attribute 
5 specifies the xpath expression used to evaluate if this rule appUes to the active message. The 
/myLibox/rule/condition/@select (string minOccurs=l maxOccurs=l) attribute specifies an 
xpath expression used to determine if this rule applies to the active message. Because rules 
only apply to messages, this statement must be scoped to the message element. Valid 
1.^ examples include "/importance = 'high"'; "/fi-om/email = * someone@microsoft.com' and 
ql 10 contains (./subject/fixU, 'hello')". Examples of invaUd statements inchide 
''J "/myInbox/message[./importance = 'high']"; "/mylnbox/folder"; "/mylnbox/rule". 
;jO The /mylnbox/nile/action (minOccurs=l maxOccurs==unbounded) field specifies an 

= individual action to perform if the select element matches minOccurs-maxOccurs messages. 

fy The /myInbox/rule/action/@seqiience (unsignedLong mmOccurs=l maxOccurs=l) required 

pit 

i;3 15 attribute specifies the order that this action should be performed in relative to all other actions 
for this rule. The /mylnbox/rule/action/copyMessage (minOccurs==0 maxOccurs=l) action is 
used to copy the active message in rules processing to another folder specified by the 
'targetFolder' element. 

The /mylnbox/rule/action/copyMessage/targetFolder (minOccurs=l maxOccurs=l) 
20 element specifies the folder to save the message to. If omitted, the message is saved in the 
drafts folder. The /myInbox/rule/action/copyMessage/targetFolder/@select (string 
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minOccurs=l maxOccurs=l) field contains the location of the folder to which save the 
message. For example. The /myInbox/folder[@id=""]. 

The /myhibox/rule/action/moveMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate fliat the active message should be moved to the targetFolder. The 
/myInbox/rule/action/moveMessage/targetFolder(minOccurs=l maxOccurs=l) element 
specifies the folder to save the message to. If omitted, tiie message is saved in the drafts 
folder. 

The /myInbox/rule/action/moveMessage/targetFolder/@select (string minOccurs=l 
maxOccurs=l) field contains the location of the folder to which save the message. For 
example, The /myInbox/folder[@id=""]. 

The /myhibox/rule/action/deleteMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should be deleted. The 
/mylnbox/rule/action/assignCategory (minOccurs=0 maxOccurs=l) field is used in rule 
actions to indicate tiiat the active message should have the included cat element added to it. 

The /myhibox/mle/action/assignCategory/cat (minOccurs=0 maxOccurs=unbounded) 
element is used to categorize the element that contains it by referencing either a global 
category definition (in either the .NET Categories service system document or an external 
resource containing category definitions), or by referencing an identity-centered category 
definition in Ihe content document of the .NET Categories service for a particular PUID. 

The /myInbox/rule/action/assignCategory/cat/@ref (anyURI minOccurs=l 
maxOccurs=l) attribute references a category definition (catDef) element using the rules 
outlined in the .NET Categories section (myCategories) described above. 
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The /mylnbox/rule/action/forwardMessage (minOccurs=0 maxOccurs=l) field is used 
in rule actions to indicate Hiat the active message should be forwarded to the included 
recipients. The /myhibox/rule/action/forwardMessage/recipient (minOccurs=0 
maxOccurs=unbounded) field specifies an e-mail address and display name, or the PUID that 
5 represents them. 

The /myInbox/rule/action/forwardMessage/recipient/@type (string minOccurs=l 
maxOccurs=l) field specifies whether the recipient is in the "to\ *cc' or *bcc' list. 

The /mylnbox/mle/action/forwardMessage/recipient/name (string minOccurs=l 
maxOccurs=l) field contains the display name of an e-mail address. The 
i;| 10 /mylnbox/rule/action/fbrwardMessage/recipie^^ 

Ms 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 

m 

!;2 counby code as described in RFC 1766. The value of this attribute indicates the language 

ii 

type of the content within this element. The 

□ 

i y /myInbox/rule/action/forwardMessage/recipient/name/@dir (string minOccurs=0 

"'" i: s 

^^3 15 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). The 

/mylnbox/rule/action/forwardMessage/recipient/email (string minOccurs=l maxOccurs=l) 
field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/rule/action/forwardAsAttachment (minOccurs=0 maxOccurs=l) field is 
20 used in rule actions to indicate that the active message should be forwarded to the included 
recipients as an attachment. The /mylnbox/rule/action/forwardAsAttachment/recipient 
(minOccurs=0 maxOccurs=unbounded) field specifies an e-mail address and display name, or 
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the PUID that represents them. The 

/myMbox/rde/action/forwardAsAttachrnen1/recipient/@ty^ (string minOccurs=l 
maxOccurs==l) field specifies whether the recipient is in the 'to', *cc' or 'bcc' hst. 

The /mylnbox/nde/action/forwardAsAttachnient/recipient/nanie (string nunOcciirs=l 
maxOcciirs=l) field contains the display name of an e-mail address. The 
/myInbox/rule/actioii/forwardAsAttachment/recipient/name/(^ml:l^^ 
maxOcciirs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myInbox/rule/action/forwardAsAttachment/recipient/name/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/rule/action/forwardAsAttachment/recipient/email (string minOccurs==l 
maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 

The /myhibox/rule/action/serverReply (minOccurs^O maxOccurs=l) field, if present, 
includes the /mylnbox/rule/action/serverReply/subject (minOccurs=l maxOccurs=l) field 
which contains the subject of the message fi:om the server. The 

/myInbox/rule/action/serverReply/subject/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myInbox/rule/action/serverReply/subject/@dir (string minOccurs=0 
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maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myLibox/mle/action/serverReply/subject/prefix (string minOccurs=l 
maxOccurs=l) field contains the prefix of a message subject (e.g., TW: '). The 
5 /mylnbox/rule/action/serverReply/subject/text (string minOccurs=l maxOccurs=l) field 
contains the subject of a message, minus the prefix (e.g., 'hello there'). 

The /mylnbox/rule/action/serverReply/simpleBody (string minOccurs=l 
maxOccurs=l) field contains a plain text simple body that should be sent firom the server. The 
/myLibox/rule/action/serverReply/simpleBody/@xml:lang (minOccurs=l maxOccurs=l) 
% 10 required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 

4 described in RFC 1766. The value of this attribute indicates the language type of the content 

pi 

0 within this element. The /nry^ox/rule/action/serverRepiysin^ (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 

n localized string. VaUd vahies are rtl (right to left) and Itr (left to right). 

4 15 The /myInbox/rule/actionA"edirectMessage (minOccurs=0 maxOccurs=l) field is used 

in rale actions to indicate that the active message should be redirected to the included 
recipient. The /mylnbox/mle/action/redirectMessage/recipient (minOccurs=0 
maxOccurs=unbounded) field specifies an e-mail address and display name, or the PUDD that 
represents them. The /myInbox/rale/action/redirectMessage/recipient/@type (string 
20 minOccurs=l maxOccurs=l) specifies whether the recipient is in the 'to', 'cc' or *bcc' list. 
The /mylnbox/rale/action/redirectMessage/recipient/name (string minOccurs=l 
maxOccurs=l) field contains the display name of an e-mail address. The 
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/myMbox/mle/actioii/redirectMessage/recipient/name/@xml^ 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myInbox/rule/action/redirectMessage/recipient/nanie/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
VaUd values are rtl (right to left) and Itr (left to right). 

The /mylnbox/rule/action/redirectMessage/recipient/email (string minOccurs=l 
maxOccurs=l) field contains an e-mail address (for example, someone@microsoft.com). 

The /mylnbox/rule/action/flagMessage (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should have the included flag added to it. The 
/mylnbox/rule/action/flagMessage/flag (minOccurs=l maxOccurs=l) optional element defines 
the flag state of the message. It includes an {any} element that can be used for extensible 
flags. 

The /mylnbox/rule/action/flagMessage/flag/state (string minOccurs==l maxOccurs=l) 
field contains the state of a message flag. The /mylnbox/rule/action/flagMessage/flag/tifle 
(string minOccurs=l maxOccurs=l) field contains the client-defined text of the flag. The 
myInbox/rule/action/flagMessage/flag/title/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of Ihe content 
within this element. The /myInbox/rule/action/flagMessage/flag/title/@dir (string 
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minOcciirs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). 

The /mylnbox/rule/action/flagMessage/flag/reminderDate (dateTime minOccurs=0 
maxOccurs=l) field contains the client-defmed reminder date of the flag. The 
/myInbox/rule/action/flagMessage/flag/{any} (minOccurs=0 maxOccurs=unbounded) field 
allows for extensibility. 

The /mylnbox/rule/action/markAsRead (minOccurs=0 maxOccurs=l) field is used in 
rule actions to indicate that the active message should be marked as read. The 
/mylnbox/rule/action/stopProcessingRulesOfrhisType (minOccurs=0 maxOccurs=l) is 
directed to stopping certain rules fi-om processing, e.g., if a rule has already handled a received 
message, certain other rules should not process it. 

The /myhibox/rule/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 
extensibiUty. 

The subscription elements and attributes are common to other services, and are 
described above. 

mvInbox/Domain Specific Methods 

The .NET hibox service has seven domain-specific messages, including a mylnbox 
/sendMessage method, which sends a plain-text or fiiUy MME-encoded message from the 
user's account. If the optional, "saveSentMessage" is included, a copy of the sent message 
will be saved in the Sent Messages folder and the responseBody will include a header element 
with the new system-defined E) attribute. 
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Another method is a mylnbox/sendMessageRequest, which is accessed using a request 
message. In response, this method may generate a response message or a SOAP Fault 
message. The following sample document fragments generally set forth the structure and 
meaning of the elements and attributes in the request and response messages. 

The following section describes the request message for this method: 



<m:sendMessageRequest 
xmlns:m=*%ttp://schemas.niicrosoft.com/hs/200 1 / 1 0/myInbox" 
xmlns:hs=="http://schemas.microsoft.com/hs/2001/10/core">i..i 

<m:draftMessage select-'... ">a.i 
<m:saveInFolderref="...">o..i</m:saveInFolder> 

</m:draftMessage> 
<m:rawMessage>o..i 
<m:messageStatus>o..i 
<m:saveInFolderref="...''>o..i</m:saveIiiFolder> 

<m:flag>o..i 

<m:state>i i</m:state> 

<m:title xml:lang="..." dir="...'>i,.i</m:title> 

<m:reminderDate>o..i</m:reminderDate> 

{any} 
</m:flag> 
{any} 
</m:messageStatus> 
<m:messageContent>o..i 
<m:cat ref="...">o..unbounded</m:cat> 
<m:raw2822Content>i..i</m:raw2822Content> 
{any} 

</m:messageContent> 
</m:rawMessage> 
</m:sendMessageRequest> 



The /sendMessageRequest (minOccurs=l maxOccurs=l) method is used to send a 
message from mylnbox. It takes a pointer to a draft message to send, or a raw message that 
represents a full RFC2822/Mime message. This method is accessed using a request message, 
and in response may generate a domain-specific response message, or may generate a SOAP 
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fault message. The types used in these messages are fully specified in the service's schema 
dociunent referenced above. 

The sendMessageRequest/draflMessage (minOccurs=0 maxOccurs=l) element is used 
to identify an existing draft to send. The /sendMessageRequest/draflMessage/@select (string 
5 minOccurs=l maxOccurs=l) item specifies an XPath expression that selects a set of nodes 
relative to the externally established context. The expression can never travel outside the 
node-set established by this externally estaWished current context. The expression can match 
zero or more nodes, and the operation manipulates all selected nodes. The minOccurs and 
maxOccurs attributes are optional and place restrictions and limitations on the number of 

;3 

:3 10 nodes selected. 

■^i The /sendMessageRequest/draftMessage/savelnFolder (minOccurs=0 maxOccurs=l) 

; J element defines the folder in which a copy ofthis message should be saved. The 
;^ /sendMessageRequest/draflMessage/saveInFolder/@ref (minOccurs=0 maxOccurs=l) 
-y uuidType is used to specify a universally unique identifier (UUID). 

;i 1 5 The /sendMessageRequest/rawMessage (minOccurs^O maxOccurs=l) element is used 

■■A 

to Specify a raw message to send. 

The /sendMessageRequest/rawMessage/messageStatus (minOccurs=0 maxOccurs=l) 
includes a The /sendMessageRequest/rawMessage/messageStatus/saveMFolder (minOccurs=0 
maxOccurs=l) element that defmes the folder in which a copy ofthis message should be 
20 saved. 
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The /sendMessageRequest/rawMessage/messageStatus/saveInFolder/@ref 
(minOccurs=0 maxOccurs=l) uuidType is used to specify a universally unique identifier 
(UUID). 

The /sendMessageRequest/rawMessage/messageStatus/flag (minOccurs=0 
maxOccurs=l) optional element defines the flag state of the message. It includes an {any} 
element that can be used for extensible flags. The 

/sendMess^eRequest/rawMessage/messageStatus/flag/state (string minOccurs=l 
maxOccurs=l) field contains the state of a message flag. The 
/sendMessageRequest/rawMessage/messageStatus/flag/title (string minOccurs=l 

maxOccurs=l) field contains the client defmed text of the flag. The 
/sendMessageRequest/rawMessage/messageStatus/flag/title/@xml:lang(minOccurs=l 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 

country code as described in RFC 1766. The value of this attribute indicates the language type 

of the content within this element. The 

/sendMessageRequest/rawMessage/messageStatus/flag/title/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left) and Itr (left to right). 

The /sendMessageRequest/rawMessage/messageStatus/flag/reminderDate (dateTime 

niinOccurs=0 maxOccurs=l) field contains the client-defined reminder date of the flag. 

The /sendMessageRequest/rawMessage/messageStatus/flag/{any} (minOccurs=0 
maxOccurs=unbounded), if present, includes the 
/sendMessageRequest/rawMessage/messageStatus/ {any} (minOccurs=0 
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maxOccurs=unbounded) field, for extensibility. The 

/sendMessageRequest/rawMessage/messageContent (minOccurs=0 maxOccurs=l) field 

represents a complete RFC2822 / MME message. The 
/sendMessageRequest/rawMessage/messageContent/cat(minOcciirs=0 
maxOccurs=unboimded) element is used to categorize the element that contains it by 
referencing either a global category definition (in either the .NET Categories service system 
document or an external resource containing category definitions), or by referencing an 
identity-centered category definition in the content document of the .NET Categories service 

for a particular PUID. 

The /sendMessageRequest/rawMessage/messageContent/cat/@ref (anyURI 

minOccurs=l maxOccurs=l) attribute references a category definition (catDef) element using 

the rules outlined in the .NET Categories section, above. 

The/sendMessageRequest/rawMessage/messageContent/raw2822Content 

(base64Binary minOccurs=l maxOccurs=l) field contains the complete RFC2822 / MIME 
content. The /sendMessageRequest/rawMessage/messageContent/{any} (minOccurs=0 
maxOccurs=unbounded) field provides for extensibility. 

Upon successfiil completion of a message request, a response message is generated by 
the sendMessageResponse method. The format of the response message is described in the 

following table: 

<m:sendMessageResponse selectedNodeCount="..." status-*..." 

xmlns:m="http://schemas.microsoft.com/hs/2001/10/mylnbox" 

xmlns:hs="http://schenias.microsoft.coin/hs/2001/10/core">i..i 

<m:newBlueIdid="...">i..i</m:newBlueId> 
</m:sendMessageResponse> . ^ 
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The /sendMessageResponse (minOccurs=l maxOccurs=l) response is used to indicate 
the success of the operation as well as the new id associated with any messages that were 
saved as a result of this method. The /sendMessageResponse/@selectedNodeCount (int 
minOccurs==0 maxOccurs=l) attribute is used to return the number of selected nodes, selected 
5 by the corresponding data language operation. 

The /sendMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If the status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
1 0 updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 

The /sendMessageResponse/newBlueld (minOccurs=l maxOccurs=l) field contains 
the new identifier of the message that was saved in mylnbox. The 

/sendMessageResponse/newBlueId/@id (minOccurs=l maxOccurs=l) attribute specifies the 

15 ID of the deleted item. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to imderstand a header 
marked as "srmustUnderstand'', a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

20 The mylnbox/saveMessage allows a cHent to add either a complete rfc822 local 

message to .NET Inbox or to save a draft message. 
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The mylnbox/saveMessageRequest method is accessed using a request message, and 
in response may generate a response message or a SOAP Fault message. The following 
sample document fragments and description below illustrate the structure and meaning of the 
elements and attributes in the request and response messages: 



<m: saveMessageRequest 
xmlns:m="http;//schemas.microsoft.coin/hs/200 1/ 1 0/myInbox" 
xnilns:hs="http://schemas.microsoft.com/hs/2001/10/core''>i..i 
<m:completeLocalMessage>o..i 
<m:messageStatus>o..i 
<m:isRead>i..i</m:isRead> 
<m:folder ref="...">,..i</m:folder> 
<m:flag>o..i 
<m:state>i..i</m:state> 
<m:title xml:lang=".„" dir="...">i..i</m:title> 
<m:reminderDate>o.,i</tn:reminderDate> 
{any} 
</m:flag> 

<m:state>i..i</m:state> 

{any} 
</m:messageStatus> 
<m:messageContent>o..i 

<m:cat ref="...">o..unbounded</ni:cat> 

<m:raw2822Content>i..i</m:raw2822Content> 

{any} 

</m:messageContent> 
</m:completeLocalMessage> 
</m: saveMessageRequest> 



The /saveMessageRequest (minOccurs==l maxOccurs=l) method is used to save a 
local message (for example in a PST file) into mylnbox. This method is accessed using a 
request message, and in response may generate a domain-specific response message, or may 
generate a SOAP fault message. The types used in these messages are fiiUy specified in the 
services base schema docxmient referenced above. 

The /saveMessageRequest/completeLocaMessage (minOccurs=0 maxOccurs=l) 
element represents a complete local message to add to mylnbox. The 
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/saveMessageRequest/completeLocalMessage/messageStatus (minOccurs=0 maxOccurs=l), 
if present, includes the /saveMessageRequest/completeLocalMessage/messageStatus/isRead 
(boolean minOccurs=l maxOccurs=l) element, which defines the read/unread state of the 
message and can be modified, 

The/saveMessageRequest/completeLocalMessage/messageStatus/folder 
(minOccurs=l maxOccurs=l) element defines the single folder that this message logically 
belongs to. The /saveMessageRequest/completeLocalMessage/messageStatus/folder/@ref 
(minOccurs=0 maxOcciirs=l) uuidType is used to specify a universally unique identifier 
(UUK)). The /saveMessageRequest/completeLocalMessage/messageStatus/flag 
(minOccurs=0 maxOccurs=l) optional element defines the flag state of the message. It 
includes an {any} element that can be used for extensible flags. 

The /saveMessageRequest/completeLocalMessage/messageStatus/flag/state (string 
minOccurs=l maxOccurs=l) field contains the state of a message flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/title (string minOccurs=l 
maxOccurs=l) field contains the client-defined text of the flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/flag/title/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/saveMessageRequest/completeLocalMessage/messageStatus/flag/title/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left) and Itr (left to right). The 
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/saveMessageRequest/completeLocalMessage/messageStatus/flag/reminderDate (dateTime 
minOccurs=0 maxOccurs=l) field contains the client-defined reminder date of the flag. The 
/saveMessageRequest/completeLocalMessage/messageStatus/ flag/ {any} (minOccurs=0 
maxOccurs=iinboimded) field provides extensibility, as described above. 
5 The /saveMessageRequest/completeLocalMessage/messageStatus/state (string 

minOccurs=l maxOccurs=l) element defines the sent/received state of the message. The 
/saveMessageRequest/completeLocalMessage/messageStatus/{any} (minOccurs=0 
maxOccurs==unbounded) field provides for extensibility. 
I ^ The /saveMessageRequest/completeLocalMessage/messageContent (minOcciirs==0 

Q 10 maxOcciirs=l) field represents a complete RFC2822 / MIME message. The 

ml: 

'J / saveMessageRequest/completeLocalMessage/messageContent/cat (minOccurs=0 

J;^ maxOcciirs=iinbounded) element is used to categorize the element that contains it by 

••.^ 

referencing either a global category definition (in either the .NET Categories service system 
jij document or an external resource containing category definitions), or by referencing an 

u s 
: s r 
: -4;? 

Q 15 identity-centered category definition in the content document of the .NET Categories service 
for a particular PUID. 

The /saveMessageRequest/completeLocalMessage/messageContent/cat/@ref (anyURI 
minOccurs=l maxOccurs=l) attribute references a category definition (catDef) element using 
the rules outlined in the .NET Categories (MyCategories) section, above. The 
20 /saveMessageRequest/completeLocalMessage/messageContent/raw2822Content 

(base64Binary minOccurs=l maxOccurs=l) field contains the complete RFC2822 / MEME 
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content. The /saveMessageRequest/completeLocalMessage/messageContent/{any} 

(minOccurs=0 maxOcciirs=unbounded) field provides for extensibility. 

Upon successful completion of this method, a response message is generated. The 

format of the response message, mylnbox/saveMessageResponse, is described next. To this 

end, the document fragment in the table below and the various meanings are described: 

<m:saveMessageResponse selectedNodeCount="..." status="..." 
xrdns:m="htlp://schenms.microsoft.coiri/hs/2001/10/mylnbox" 
xmlns:hs-"http://schemas.microsoft.coin/hs/2001/10/core">i..i 
<m:newBlueId id="...">i..i</m:newBlueId> 
</m:saveMessageResponse> 

The /saveMessageResponse (minOccurs=l maxOccurs=l) response contains a 
newBlueld for each message that was successfully saved. The 

/saveMessageResponse/@selectedNodeCount (int minOccurs=0 maxOccurs=l) attribute is 
used to return the number of selected nodes, selected by the corresponding data language 
operation. The /saveMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If Ihe status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 

The /saveMessageResponse/newBlueld (minOccurs=l maxOccurs=l) element 
represents the new or saved message. The /saveMessageResponse/newBlueId/@id 
(minOccurs=l maxOccurs=l) attribute specifies the ID of the deleted item. 



-310- 



If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
marked as "srmustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 

The mylnbox/copyMessage method allows cUents to copy one or more messages into a 
folder. The message data, (including attachments) is copied and new message headers are 
retumed with unique header ID values. 

The mylnbox/copyMessageRequest method is accessed using a request message, and 
in response may generate a response message or a SOAP Fault message. The following 
sample document fi-agments and following description illustrate the structure and meaning of 
the elements and attributes in the request and response messages: 

<m: copyMessageRequest useClientIds=" ..." 

xmlns:m="http://schemas.microsoft.coni/hs/2001/10/mylnbox" 

xmlns:hs="ht^://schemas.microsoft.coni/hs/2001/10/core''>i..i 

<m:message select^"..." copyAsDraft='\.." clientId="...">i..^i,ounded</m:message> 

<m:targetFolderref="...">i..i</m:targetFolder> 
</m:copyMessageRequest> 

The /copyMessageRequest (minOccurs=l maxOccurs=l) message allows chents to 
copy one or more messages to a folder. The message data (including attachments) is copied 
and new message messages are retumed with unique message ID values. This element 
encapsulates the arguments to the copyMessage method. It contains a message element and a 
targetFolder element. 

The /copyMessageRequest/@useCHentIds (boolean minOccurs==0 maxOccurs=l) 
optional attribute, if present, specifies that each message element's id attribute will be used as 
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the new id. The /copyMessageRequest/message (minOccurs=l maxOcciirs=uiibounded) 
element contains a select statement that contains an XPATH expression indicating a message 
for which to copy the associated message. 

The /copyMessageRequest/message/@select (string minOccurs=l maxOccurs=l) field 
contains the location of the message (which is associated with the message) to copy, e.g., 
/myInbox/message[@id=""] . 

The /copyMessageRequest/message/@copyAsDraft (boolean minOccurs=0 
maxOccurs=I), if this value is present and set to true, causes the message to be copied as a 
draft into the target folder. 

The /copyMessageRequest/message/@clientId (minOccurs=0 maxOccurs=l) attribute 
specifies that the server should use the value of this attribute as the id of the new message; 
useClientlds should be present on the copyRequest element and set to true 

The /copyMessageRequest/targetFolder (minOccurs=l maxOccurs=l) field contains 
the id of an existing folder to copy the message(s) to. 

The /copyMessageRequest/targetFolder/@ref (minOccurs=0 maxOccurs=l) uuidType 
is used to specify a universally unique identifier (UUID), 

Upon successful completion of this method, a response message, 
mylnbox/copyMessageResponse, is generated. The format of the response message is 
described next: 

<m:copyMessageResponse selectedNodeCount-*..." status-'..." 

xmlns:m="http://schemas.microsoft.coni/hs/2001/10/mylnbox" 

xmlns:hs="http://schemas.inicrosoft.corii/hs/2001/10/core">i.j 

<m:newBlueId id="...">i..i</m:newBlueId> 
</m:copyMessageResponse> 
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The /copyMessageResponse (minOccurs=l maxOccurs^l) response from 
copyMessage includes a newBlueld element for each successfully copied message. The 
/copyMessageResponse/@selectedNodeCount (int minOccurs=0 ma?cOccurs=l) attribute is 
used to return the number of selected nodes, selected by the corresponding data language 
operation. 

The/copyMessageResponse/@status (string minOccurs=l maxOccurs=l) attribute 
indicates the status of the method. If the status is success, the corresponding method was 
completed successfully. If the status is failure, the corresponding method was not completed 
successfully. If the status is rollback, the method failed, but was rolled back to its pre- 
updateBlock status. If the status is notAttempted, the corresponding method was not 
attempted. This occurs when a previous operation failed. 

The /copyMessageResponse/newBlueld (minOccurs=l maxOccurs==l) element is 
typically found in the body of an insertResponse, updateResponse, or replaceResponse to 
indicate that a new ID value was generated by the corresponding request operation. 
Applications, in response, need to walk through their changes in order, and apply the retumed 
ID to any cached value of the node they just inserted. Only a new ID generation triggers this, 
so in the case of an ID-preserving replaceRequest, the root of the replacement never generates 
one of these, but an inner xdb:blue does. 

The /copyMessageResponse/newBlueId/@id (minOccurs=l maxOccurs=l) attribute 
specifies the ID of the deleted item. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to understand a header 
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marked as "srmustUnderstand", a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 



mvLocation 

5 The .NET myLocation service is designed to provide a repository for location reports 

on the current location of the identity boxmd to the service. The service is not designed to 
provide realtime streamed location reporting. For this application, a location stream should be 
connected via the .NET Presence service. 



mvLocation / Roles 

The myLocation service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
scope allElements 

<hs:scopeid-7215df55-e4af-449f-a8e4-72alf7c6a987> 

<hs:shape base==t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id-al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 

<hs:include select=//*[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7fD5a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base=nil> 
<hs:includeselect=//subscription[@creator=*$callerId']/> 

</hs:shape> 
</hs:scope> 
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scope onlyPublicElements 

<hs:scopeid=da025540-a0c0-470f-adcf-9fD7e5a5ec8f> 

<hs;shape base=nil> 
<hs:include select=//*[cat/@ref=*hs:public']/> 
<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 



The myLocation roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myLocation service through that method while mapped to this 
roleTemplate: 

TABLE - myLocation roleTemplate rtO 



method 


scope/name 


Query 


allElements 


Lisert 


allElements 


Replace 


allElements 


Delete 


allElements 


Update 


allElements 



The myLocation roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role also have a limited ability to write to information in the 
content document. Applications may create nodes in any location, but may only 
change/replace, or delete nodes that they created. The following table illustrates the available 
methods and the scope in effect when accessing the myLocation service through that method 
while mapped to this roleTemplate: 
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TABLE - myLocation roIeTemplate rtl 



method 


|scope/name 


Query 


allElements 


[insert 


onlj^elfElements 


[Replace 


onlySelfElements 


iDelete 

1 . J 


onlySelfElements { 



The myLocation roIeTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roIeTemplate. 
Apphcations mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myLocation service through that method 
while mapped to this roIeTemplate: 

TABLE - myLocation roIeTemplate rtl 



method 


scope/name ! 


Query 


allElements ! 


Insert 


onlySelfSubscriptionElementSi 


replace 


onlySelfSubscriptionElements ; 


Delete 


onlySelfSubscriptionElements i 



The myLocation roIeTemplate rt3 role gives limited read access to information within 
the content document that is categorized as "public." The following table illustrates the 
available methods and the scope in effect when accessing the myLocation service through that 
method while mapped to this roIeTemplate: 
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myLocation roleTemplate rt3 



1 method 


scope/name 


iQuery 


onlyPublicElements; 



The myLocation roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 

myLocation / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myLocation service: 

<m:myLocation changeNumber= =''..." instanceld=".. 
xmlns:m="http://schemas.microsoft.com/hs/2001/10/myLocation" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:location changeNumber^ ^ id="..;' creator='\..''>o..„nbounded 
<m;cat rrf="...">n.„nw^.H< /m;cat> 
<m:address>i..i 
<hs;cat ref="...">n.nnhnnnH.H< /hs;cat > 

<hs:officialAddressLinexml:lang="..." dir="...">o..i</hs:officialAddressLine> 

<hs:intemalAddressLine xml:Iang=="..." dir="...">o.,i</hs:intemalAddressLine> 

<hs:primaryCity xml:lang="..." dir="...">o..i</hs:priniaryCity> 

<hs:secondaryCity xml:lang="..." dir="...">a.i</hs:secondaryCity> 

<hs:subdivision xml:lang="..." dir="...">o..i</hs:subdivision> 

<hs:postalCode>o..i</hs:postalCode> 

<hs:countryCode>o..i</hs:countr3K;;ode> 

<hs:latitude>o..i</hs:latitude> 

<hs:longitude>o..i</hs:longitude> 

<hs:elevation>o..i</hs:elevation> 

<hs:velocity>o..i 

<hs: speed>o..i</hs: speed> 

<hs:direction>o..i</hs:direction> 
</hs:veIocity> 

<hs :confidence>o.. i </hs : confidence> 
<hs:precision>o..i</hs:precision> ^ 
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{any} 
</m:address> 

<m:reportmgDevice>i . J </m:reportingDevice> 
<m;lastUpdateTime >i t < /m:IastUpdateTime> 
<in:expiresAt> n i< /m:expiresAt> 
fanvf 
</m:Iocation> 

<m:subscriptioii changeNmnber =''../' id="..." creator="...''>o .unboimded 

<hs:trigger select="..." mode="..." baseChangeNuinber="...">i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri="...">i..i /iQf/iy/</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscriptioii> 
{any} 

</m;myLocatioii> 



The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimimi occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myLocation (minOccurs=l maxOccurs=l) element encapsulates the content 
document for the .NET Location service. The /myLocation/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /myLocatioii/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a 
unique identifier typically assigned to the root element of a service. It is a read-only element 
and assigned by the .NET My Services system when a user is provisioned for a particular 
service. 
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The /myLocation/location (minOcciirs=0 maxOccurs==unbomided) node has a 
/myLocation/location/@changeNuniber (minOccurs=0 maxOcciirs=l) changeNumber 
attribute, designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
5 applications. Attempts to write this attribute are silently ignored. 

The /myLocation/location/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this elanent by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
f 2, 10 useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
Sj and attempts to write it are silently ignored. 

The /myLocation/location/@creator (string minOccurs=0 maxOccurs=l) attribute 

•5 St? 

!' , identifies the creator in terms of userld, appid, and platformid of the node. 

Q 

i'sj The /myLocation/location/cat (minOccurs=0 maxOccurs=unbounded) element is used 

Q 15 to categorize the element that contains it by referencing a global category definition in either 
the .NET Categories service system document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myLocation/location/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
20 references a category definition (<catDe£^>) element using the rules outlined in the 
myCategories section, described above. 



-319- 



The/myLocation/address/officialAddressLine (string minOccurs=0 maxOccurs=l) 
element contains the most precise, official line for the address relative to the postal agency 
servicing the area specified by the city(s)/postalCode. When parsing an address for official 
postal usage, this element contains the official, parsable address Hne that the regional postal 
system cares about. Typical usage of this element would be to enclose a street address, post 
office box address, private bag, or any other sunilar official address. Internal routing 
information like department name, suite number within a building, internal mailstop number, 
or similar properties should be placed within the intemalAddressLine element. The 
/myLocation/address/officialAddressLine/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myLocation/address/officiaLAddressLine/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaHzed string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myLocation/address/intemalAddressLine (string minOccurs=0 maxOccurs=l) 
element contains internal routing information relative to the address specified by the 
officialAddressLine. Items like department name, suite number within a building, internal 
mailstop number, or similar properties should be placed within this element. The 
/myLocation/address/interaalAddressLine/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myLocation/address/intemalAddressLine/@dir (string 
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minC)ccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myLocation/address/primaryCity (string minOccurs=0 maxOccurs=l) element 
defines the primary city for this address. The /myLocation/address/primaryCity/@xml:laiig 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of tiie content within this element. The 

/myLocation/address/primaryCity/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
specifies the default layout direction for the localized string. Valid values are rtl (right to left), 
and Itr (left to right). 

The /myLocation/address/secondaryCity (string minOccurs=0 maxOccurs=l) optional 
element defines the secondary city for this address. Example types for this element include 
city district, city wards, postal towns, and so on. The 

/myLocation/address/secondaryCity/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myLocation/address/secondaryCify/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies tiie default layout direction for the localized string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myLocation/address/subdivision (string minOccurs=0 maxOccurs=l) element 
contains the official subdivision name within the country or region for this address. In the 
United States, this element would contain the two letter abbreviation for the name of the state. 
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This element is also commonly treated as the "first order admin subdivision" and will 
typically contain subdivision names referring to administrative division, Bundesstaat, canton, 
federal district, province, region, state or territory. The 

/myLocation/address/subdivision/@xml:lang(minOccurs=l maxOccurs=l) required attribute 
is used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this element. 
The /myLocation/address/subdivision/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 

The /myLocation/address/postalCode (string minOccurs=0 maxOccurs=l) element 
contains the official postal code for this address. The /myLocation/address/countryCode 
(string minOccurs=0 maxOccurs=l) element contains the 2 letter ISO-3166 id of the country, 
dependency, or fimctionally equivalent region for this address. The 
/myLocation/address/latitude (string minOccurs=0 niaxOccurs=l) element specifies the 
latitude value for this address in units of decimal degrees. Geodetic datum WGS84 is 
required. The /myLocation/address/longitude (string minOccurs=0 maxOccurs=l) element 
specifies the longitude value for tiiis address in units of decimal degrees. Geodetic datum 
WGS84 is required. The /mylLocation/address/elevation (string niinOccurs=0 maxOccurs=l) 
element specifies the elevation above sea level with respect to WGS84 geodetic datijm. The 
units for this value is meters. 

The /myLocation/address/velocity (minOccurs=0 maxOccurs=l) element specifies the 
last reported velocity associated with this address. Of course, for fixed addresses the velocity 
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node would either not be present, or speed would be zero indication stationary position. The 
/myLocation/address/velocity/speed (string minOccurs=0 maxOccurs=l) element specifies the 
last known speed associated with this report in units of meters per second. The 
/myLocation/address/velocity/direction (string minOccurs=0 maxOccurs=l) element specifies 
the last known direction associated with this report in units of degrees decimal. The 
/myLocation/address/confidence (string minOccurs=0 maxOccurs=l) element specifies a 
percentage value that indicates the confidence value that this location is accurate within the 
specified precision. The /myLocation/address/precision (string minOccurs==0 maxOccurs=l) 
element specifies the precision in meters of this location. The value defines a spherical zone 
that the location falls within. 

The /myLocation/location/address/{any} (minOccurs=0 maxOccxirs=nmbounded) 
allows for address-related extensibility. 

The /myLocation/location/reportingDevice (anyURI minOccurs=l maxOccurs=l) 
element contains the device name of the device supplying this location information. The name 
is encoded as a URI. One common format for this name is a uuid: scheme uri interpreted as a 
"Universal Device Number" as exposed by a Universal Plug and Play infi-astructure. 

The /myLocation/location/lastUpdateTime (dateTime minOccurs=l maxOccurs=l) 
element specifies the last update thne of this location report. The 
/myLocation/location/expiresAt (dateTime minOccurs=0 maxOccurs=l) optional element 
specifies the time after which this location report is considered expires. The system is fi:ee to 
delete expired elements on its own schedule. 
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The /myLocatioii/location/{ariy} (minOccurs=0 maxOccurs=ainbounded) field allows 
for location-related extensibility. 

The /myLocation/subscription (minOccurs=0 maxOccurs=imbounded) element defines 
a subscription node as described above in the subscription section. 

mvLists 

The .NET Lists service is a general purpose service designed to manage simple lists 
with minimal structure for what a list is, and what an item is within a hst. Like other .NET 
My Services, the .NET Lists service allows fi-ee-form, name-space qualified extensions to be 
added to a list, or an item within a list. This mechanism is useful to add semi-structured 
information to the service with a downside that the service is unable to schema-validate these 
extensions. 

The .NET Lists service breaks down a Hst into two major components which are the 
hst defined by the list element, and an item defined by the item element. 

The list element is designed to contain the definition of a list and serves as an anchor 
location to which items that belong to that hst may refer. Lists may also refer to Usts. In any 
event, the hnkage is designed to be a soft linkage so that list definitions may be defined within 
the confines of the .NET Lists service as well as external to the service. This linkage pattern 
is that same as the linkage pattern used between element categorization and category 
definitions as defined in the .NET Category section, above. With this linkage model, the 
service is able to support personal list definitions in the per-user content document, global list 
definitions in the shared system document, and external hst definitions stored in other 
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addressable resources. The .NET Lists service defines a number of pre-defined lists in the 
system document. An xpQueiy of //sys:hst fix>m the .NET Lists service's system document 
will return these hsts. 

The item element is designed to rq)resent something that belongs to one or more lists. 
An item may be categorized (personal, private, sports, and so on) using standard .NET My 
Services categorization techniques, must have a title, an optional full description, may contain 
external references via the URL namespace, may be associated or "assigned" to another user, 
and so on. As noted above, an item refers to a list element, and may in fact refer to multiple 
list elements. There are however no referential integrity checks made through these references 
because as will be seen, some will likely use the reference itself as an imphcit definition of a 
list elemait and in some cases, that element may not exist or may be inaccessible. 

An item associates itself with one or more Hsts by using the listRef element and 
specifying a relative or absolute URI in the UstRe£'@ref attribute. The URI is able to refer to 
a list element by name where the hst element is physically stored in the system document of 
the .NET Lists service, the content document of the .NET Lists service and/or an arbitrary 
XML file located by URI containing list elements. 

The listRef element refers to a hst definition by absolute or relative URI. The linkage 
between the two is through the Ust/@idName attribute and the listRe£'@ref attribute. The 
Us1/@idName attribute specifies the local id for the list definition, and the hstReF@ref 
attribute is the value of that reference. 

The value of the UstRefi'@ref attribute may take the form: 
system #name-of-list 



-325- 



The list definition being referenced is located in the system document of the .NET 
Lists service, and its Ust/@idName attribute is "name-of-list". For example, tiie list reference 
of <listRef ref="system#todo"/> is a reference to the Ust definition whose list/@idName value 
is "todo", and tiiat this list definition is located in the system document of the .NET Lists 
service z.e.<hst idName="todo"/>. 

The value of the UstRef'i^ef attribute may also take the form: 
content[?puid=puid-value]#name-of-list 

The list definition being referenced is located in the content document of the .NET 
Lists service, and its list/@idName attribute is **name-of-Ust". The instance of the .NET Lists 
service {i.e., the puid of the service) is imphed by the context of the reference. This maybe 
made explicit by inserting ?puid=puid-value to the URI, and when this is done, it means the 
contait document of the .NET Lists service whose puid is "puid-value" holds the Ust 
definition. For exMiple, the list reference of <hstRef ref="content#bellSqaureShoppmg"/> is 
a reference to the list definition whose hst/@idName value is "bellSquareShopping", and that 
this Ust definition is located in the content document of die .NET Lists service for the current 
puid /,e.<Ust idName="bellSquareShopping"/>. 

The value of the hstRe£'@ref attribute may also take the form: 
any-urt#name-of-list 

The category Ust being referenced is located in an extemd (to .NET My Services) 
resource. The "any-uri" portion of the reference refers to a resource containing the Ust 
element whose @idName attribute matches the "name-of-Ust". The mapping between the 
"any-uri" portion of the reference sxxd an XML document containing the Ust elements is a 
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function of the "any-uri". By convention, this uri is the name of an XML document 
containing those elements. The purpose of this reference form is to allow and support a free 
form set of extended hst definitions that are global and available to all. For example, the list 
reference of <cat ref^*littp://schemas.xyz.com/im/hsts.xml#imChatRoom"/> is a reference to 
the hst definition whose Ust/@idName value is "imChatRoom", and that this category 
definition is located in an extemal resource located at "http://schemas.xyz.com/im/hsts.xmr\ 
Note that it is expected that hst definitions will exist in the appropriate locations, but there is 
no requirement or enforcement of this. 

hi any events, the mapping between a hstRef reference, and the list definition is very 

simple: 

1 . Locate the document containing the hst definition by taking the name prior 
to the "#". 

2. If the document is "system'', then the document containing the Ust 
definition is the system document of the .NET Lists service and is 
addressed using request/@service="myLists" and 
request/@document="system". 

3. If the document is "content", then the document containing the hst 
definition is the content document of the .NET Lists service and is 
addressed using request/@service="myLists" and 
request/@document="contenf If the ?puid=puid-value argument is 
present, the request is fiirther quahfied by request/key/@puid="puid- 
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value''. Otherwise, this attribute contams the puid of the document 
containing the reference. 

4. For any other document, the value is the uri of the XML document 
containing the list definition. 

5. Locate the Ust idName which is the portion of the reference after the "#". 

6. With the document in hand, the xpath expression //list[@idName='Ust-id'] 
selects the list definition. 



Like several other .NET My Services, the .NET Lists service makes use of 
categorization in order to classify, and categorize, both Usts and elements. 



mvLists / Roles 

The myLists service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
scope allEIements 

<hs:scope id-7215df55-e4af-449f-a8e4-72alf7c6a987> 
<hs:shape base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs: shape base=nil> 

<hs:includeselect=//*[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 
<hs:shape base=^l> 
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<hs:includeselect=//subscription[@creator='$callerId']/> 
<;/hs;shape> 

<i1is:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8f> 
<hs:shape base=ml> 

<hs:include select=//*[cat/@re^'hs:public']/> 

<hs:includeselect=//subscription[@creator='$callerId']/> 
</hs:shape> 

</hs:scope> 



The myLists roleTemplate rtO role gives complete read/write access to the information 
within the content document of the service being protected through this roleTemplate. The 
following table illustrates the available methods and the scope in effect when accessing the 
myLists service through that method while m^ped to this roleTemplate: 



TABLE - myLists roleTemplate rtO 



method 


scope/name 


Query 


allElements | 


Insert 


allElements i 


Replace 


allElements i 


Delete 


allElements 


Update 


allElements 



The myLists roleTemplate rtl role gives complete read access to all information within 
the content document of the service being protected through this roleTemplate. Applications 
mapping to this role also have a limited ability to write to mfonnation in the content 
document. Applications may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
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scope in effect when accessing the myLists service through that method while mapped to this 
roleTemplate: 



TABLE - myLists roIeXemplate rtl 



method 


scope/name 


Query 


allElements 


Insert 


onlySelfElements 


Replace 


onlySelfElementsI 


Delete 


onlySelfElementSj 



The myLists roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myLists service through that method 
while mapped to this roleTemplate: 

TABLE - myLists roleTemplate rt2 



1 method 


scope/name \ 


iQuery j 


allElements 


[insert 


onlySelfSubscriptionElements^ 


[replace 


onlySelfSubscriptionElements ! 


[Delete | 


onlySelfSubscriptionElementsi 



The myLists roleTemplate rt3 role gives limited read access to information within the 
content document that is categorized as 'public." The following table illustrates the available 
metiiods and the scope in effect when accessing the myLists service through that method 
while mapped to this roleTemplate: 
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myLists roleXemplate rt3 



method 


scope/name 


Query 


onlyPublicElements; 



The myLists roleXemplate rt99 blocks access to the content document. Note that lack 
of a role in the roleList has the same effect as assigning someone to rt99. 



mvLists / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the docxmient is 
controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
docxmient for the myLists service: 



<m:myLists changeNumber="..." instanceld=="..." 
xmlns:m="http://schemas.microsofl.coni/hs/2001/10/myLists" 
xmlns:hs="http://schemas,microsoft.com/hs/2001/10/core''>i..i 
<m:device changeNumber= ",.;^ id-"..." creator="...">o..unbounded 

<m;cat ref=".,.''>o..uiibounde(i</micat> 

<m;deviceld> i i< /m;deviceld> 

<m;carrierld> i i < /m;carrierId> 

<m:name xml:lang="..." dir="...">i„i</m:name> 

<m; address> o ,.nhn„,.HpH< /m:address> 

{any} 
</m:device> 

<m:sub$cription chaiigeNttmber= "..." id="... ' creator= "...">n 

<hs:trigger select-"..." mode-"..." baseChangeNumber="...">i.,i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri="...">i..i /iiiiyy</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscriptioii> 
{any} 

</m;myLists> 
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The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimimi occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myLists (minOccurs=l maxOccurs=l) element encapsulates the content 
document for the .NET Lists service. The /myLists/@changeNumber (minOccurs=0 
maxOccurs=l) changeNumber attribute is designed to facihtate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. 

The /myLists/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /myLists/list (minOccurs=0 maxOccurs=unbounded) element defines a list which 
includes categorization of the list, a localized name for the list, a brief description of the list, 
and any other appUcation specific properties contained within the any block(s). 

The /myLists/Ust/@idName (string minOccurs=0 maxOccurs=l) attribute specifies the 
name of the Hst that can be used in a list reference. Note that list references are coded as URIs 
in both absolute, and myLists relative forms. This attribute is the value of the fi-agment 
identifier from those URIs. For example, a UstRe£^@ref value of "system#todo" would map 
to a Ust element whose @idName attribute was todo, and that is located in the system 
document of the myLists service. 
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The /myLists/list/@changeNumber (minOccurs=0 maxOcciirs=l) changenumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The /myLists/list/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
AppUcation software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. 

The /myLists/list/@creator (string minOccurs=0 maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. 

The /myLists/list/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The /myLists/list/cat/@ref (anyURI 
minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef^>) element 
using the rules outlined in the myCategories section described above. 

The /myLists/list/UstRef (minOccurs=0 maxOccurs=unbounded) element specifies the 
lists that this item is considered contained within. Note that it is valid to have a free-form Ust 
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item that is not considered to be in part of any list, which is why this element is not required 
(minOccurs=0), 

The /myLists/hst/listRe£7@ref (anyURI minOccurs=0 maxOccurs=l) attribute contains 
the name of a list element encoded as a URI. The URI follows encoding rules similar to those 
used in cat/catDef linkage: 

system#name-of-list 

The list (definition) being referenced is located in the system document of the .NET 
Lists service, and its list/@idName attribute is "name-of-hst". For example, the listRef of 
<listRef ref="system#todo"/> is a reference to the list definition whose list/@idName value is 
"todo", and that this list definition is located in the system document of the .NET Lists service 
i.e.<list name='*todo7>. 

content[?puid==puid-value]#name-of-list 

The list definition being referenced is located in the content document of the .NET 
Lists service, and its list/@idName attribute is "name-of-list". The instance of the .NET Lists 
service (i.e., the puid of the service) is impHed by the context of the reference. This may be 
made explicit by inserting ?puid=puid-value to the URI, and when this is done, it means the 
content document of the .NET Lists service whose puid is "puid-value" holds the fist 
definition. For example, the list reference of <listRef ref="content#bellSqareShopping"/> is a 
reference to the fist definition whose list/@idName value is "bellSquareShopping", and that 
this list definition is located in the content document of the .NET List service for the current 
puid i.e.<list name="bellSquareShopping"/>. 
any-uri#name-of-list 
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The list definition being referenced is located in an external (to .NET My Services) 
resource. The "any-uri" portion of the reference refers to a resource containing the hst 
element whose @idName attribute matches the "name-of-Ust". The mapping between the 
"any-uri" portion of the reference and an XML document containing the list elements is a 
function of the "any-uri". By convention, this uri is the name of an XML document 
containing tiiose elements. The purpose of this reference form is to allow and support a free 
form set of extended Ust defmitions that are global and available to all. For example, the Ust 
reference of <listRef ref="http://schemas.xyz.com/im/globalLists.xml#xyzStuff"/> is a 
reference to the Ust definition whose Hst/@idName value is "xyzStuff", and that this Ust 
definition is located in an external resource located at 

'littp://schemas.xyz.com/im/globalLists.xml". Note that it is expected that Ust definitions will 
exist in the appropriate locations, but there is no requirement or enforcement of this. 

The /myLists/Ust/UstReflgorder (int minOccurs=0 maxOccurs=l) attribute contains 
an optional numeric order for the containing item relative to this Ust. Since an item (or even a 
Ust) may logically be contained within multiple Usts, the order of the item is attached to the 
Ust reference so that an item's order can vary based on the Ust that it is contained within. 

The /myLists/Ust/title (string minOccurs=0 maxOccurs=unbounded) element specifies 
the title of the list. The /myLists/list/title/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
described in RFC 1766. The value of this attribute mdicates the language type of the content 
within this element. The /myLists/list/title/@dir (string minOccurs=0 maxOccurs=l) optional 
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attribute specifies the default layout direction for the localized string. Valid values ^e rtl 
(right to left), and Itr (left to right). 

The /myLists/Ust/description (string minOccurs=0 maxOccurs=unbounded) element 
specifies a more detailed description of the list. The /myLists/list/description/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of flie content within ttiis element. The /myLists/list/description/@dir 
(string minOccurs=0 maxOccurs=l) optional attribute specifies the base direction of 
directionally neutral text. Possible values include rtl (right to left), or Itr (left to right). 

The /myLists/list/status (anyURI minOccurs=0 maxOccurs=l) contains a status value 
for a list the optional status of that Ust. This elements value is coded as a category reference 
and follows the same rules as foimd in the usage of cat/@ref The value may reference a 
category in the myCategories system document, a private status value in the user's 
myCategories content document, or an external category definition. It is expected that pre- 
defined system category values in the "system#status" category will be used and this would 
mean that expected values for this element include s)^tem#notStarted, system#inProgress, 
system#completed, system#waiting and system#defered. 

A node select of "//sys:catDef[hs:cat[@ref='system#status']" will locate all defmitions 
for system defined status values. 

The /myLists/list/{any} (niinOccurs=0 maxOccurs=unbounded) provides extensibihty. 

The /myLists/item (minOccuis=0 maxOccurs=mibounded) element defines a list item, 
something that is considered as part of a hst. An item may be part of multiple lists by 
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including multiple listRef elements. These listRef elements may refer to list elements in the 
content document, the system document, or to extemal resources containing list elements. 

The /myLists/item/@changeNumber (minOccurs=0 maxOccurs=l) changenumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The /myLists/item/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. 

The /myLists/item/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformid of the node. 

The /myLists/item/cat (minOccurs=0 maxOccurs==unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /myLists/item/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute references 
a category definition (<catDeC^) element using the rules outlined in the myCategories section 
described above. 



-337- 



The /myLists/item/title (string minOccurs=0 maxOcciirs=iinbounded) element 
specifies the title of the Ust item. The /myLists/item/title/@xml:lang (minOccurs==l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
5 type of the content within this element. The /myLists/item/title/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to lefl:), and Itr (left to right). 

The /myLists/item/description (string minOccurs=0 maxOccurs=unbounded) element 
specifies a more detailed description of the list item. The 

|: use 
.: ssss. 

r] 10 /myLists/item/description/@xml:lang (minOccurs=l maxOccurs=l) required attribute is used 
'J to specify an ISO 639 language code or an ISO 3 166 coimtry code as described in RFC 1766. 
j^" The value of this attribute indicates the language type of the content within this element. The 
i ^ /myLists/item/description/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
1 y specifies the base direction of directionally neutral text. Possible values inchide rtl (right to 

i; n I 
' w 

Q 15 left), or Itr (left to right). 

The /myLists/item/url (anyURI minOccurs=0 maxOccurs=ambounded) optional 
element specifies a URL associated with this Ust item. 

The /myLists/item/listRef (minOccurs=l maxOccurs=unbounded) element specifies 
the lists that this item is considered contained within. 
20 The /myLists/item/listRef/@ref (anyURI minOccurs=0 maxOccurs= 1 ) attribute 

contains the name of a list element encoded as a URI. The URI follows encoding rules similar 
to those used in cat/catDef linkage: 
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system#name-of-list 

The list (definition) being referenced is located in the system document of the ,NET 
Lists service, and its list/@idName attribute is "name-of-Usf \ For example, the listRef of 
<listRef ref=**system#todo*V> is a reference to the list definition whose list/@idName value is 
5 "todo", and that this list definition is located in the system document of the .NET Lists service 
i.e,<list name='todo'V>. 

content[?puid=puid-value]#name-of-Ust 
The list definition being referenced is located in the content document of the .NET 
Lists service, and its list/@idName attribute is "name-of-lisf . The instance of the ,NET Lists 
i; 3 10 service (i.e., the puid of the service) is implied by the context of the reference. This may be 
''4 made explicit by inserting ?puid=puid-value to the URI, and when this is done, it means the 
content document of the .NET Lists service whose puid is "puid-value" holds the Ust 
definition. For example, the list reference of <UstRef ref^"content#bellSqareShopping"/> is a 
! y reference to the Ust definition whose list/@idName value is *1)ellSquareShopping", and that 
Q 1 5 this Hst definition is located in the content document of the .NET List service for the current 
puid i.e.<Ust name="bellSquareShopping"/>. 
any-uri#name-of-Ust 

The list definition being referenced is located in an extemal (to .NET My Services) 
resource. The "any-uri" portion of the reference refers to a resource containing the list 
20 element whose @idName attribute matches the "name-of-Ust". The mapping between the 
"any-uri" portion of the reference and an XML document containing the Ust elements is a 
function of the "any-uri". By convention, this uri is the name of an XML document 
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containing those elements. The puipose of this reference form is to allow and support a free 
form set of extended list definitions that are global and available to all. For example, the list 
reference of <listRef ref="http://schemas.xyz.com/im/globalLists.xml#xyzStufirV> is a 
reference to the list definition whose Hst/@idName value is "xyzStuff", and that this list 
definition is located in an external resource located at 

"http://schemas.xyz.com/im/globalLists.xml". Note that it is expected that list definitions will 
exist in the ^propriate locations, but there is no requirement or enforcement of this. 

The /myLists/item/listRef @order (int minOccurs=0 maxOccurs=l) attribute contains 
an optional numeric order for the containing item relative to this Ust. Since an item (or even a 
list) may logically be contained within multiple lists, the order of the item is attached to the 
list reference so that an item's order can vary based on the hst that it is contained within. 

The /myLists/item/date (dateTime minOccurs=0 maxC)ccurs=unbounded) optional 
element specifies a categorized date/time for this item, A single optional category reference 
may be attached to the date. It is expected that system defined dates like "system#dueDate" 
will be used, but this is not meant to be limiting. 

The /myLists/item/date/@ref (anyURl minOccurs=0 maxOccurs=l) optional attribute 
is a reference to an existing category for this date. For instance, a value of "system#dueDate" 
implies that this date is a due date. 

The /myLists/item/statiis (anyURI minOccurs=0 maxOccurs=l) status value for an 
item indicates the optional status of that item. This element's value is coded as a category 
reference and follows the same rules as found in tiie usage of cat/@ref The value may 
reference a category in tiie myCategories system document, a private status value in the user's 
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myCategories content document, or an external category definition. It is expected that pre- 
defined system category values in the "system#status" category will be used and this would 
mean that expected values for this element include system#notStarted, system#inProgress, 
system#completed, system#waiting and system#defered, 

A node select of "//sys:catDef[hs:cat[@ref='system#status']" will locate all definitions 
for system defined status values. 

The /myLists/item/priority (anyURI minOccurs=0 maxOccxirs=l) contains a priority 
value for an item indicates the optional importance, or priority of that item. This elements 
value is coded as a category reference and follows the same rules as found in the usage of 
cat/@ref The value may reference a category in the myCategories system document, a private 
priority value in the user's myCategories content document, or an external category definition. 
It is expected that pre-defined system category values in the "system#priority'' category will 
be used and this would mean that expected values for this element include system#lowest, 
system#belowNormal, system#normal, system#aboveNormal and system#highest. 

A node select of "//sys:catDef[hs:cat[@ref='system#priority']" will locate all 
definitions for system defined priority values. 

The /myLists/item/assignedTo (minOccurs=0 maxOccurs=unbounded) optional 
element may be repeated and specifies who the item is "assigned" to. It is most usefiil when 
sharing a Ust in myLists. 

The /myLists/item/assignedTo/name (string minOccurs=0 maxOccurs=l) optional 
element specifies the name for the enclosing element. The 

/myLists/item/assignedTo/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
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is used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. The /myLists/item/assignedTo/name/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
are rtl (right to left), and Itr (left to right). 

The /myLists/item/assignedTo/puid (string minOccurs==0 maxOccurs=l) optional 
element specifies the name for the enclosing element. The /myLists/item/assignedTo/email 
(string minOccurs=0 maxOccurs=l) optional name specifies an email address for the 
enclosing element. The /myLists/item/{any} (minOccurs=0 maxOccurs=unbounded) and 
/myLists/list/{any} (minOccurs=0 maxOccurs=unbounded) allows for extensibility of this 
schema. 

The /myLists/subscription (minOccurs=0 maxOccurs=unbounded) element defines a 
subscription node as described above in the subscription section. 

The following table illustrates the structure and contents of a simple "tripList" Hst. 
Note that changeNumbers, creator attributes, and other bookkeeping items are not included in 
this example for purposes of simplicity. 
<myLists> 

<list idName="tripList" id= 

<title xml:lang-"en" dir="ltr">SVC Trip, Todo List</title> 

<UstRef idName ="sYstem#todo" order="l"/> 

<status>system^finProgress</status> 
</lis1> 

<itemid-"2"> 

< title xml:Iang="EN">Make Dental Appointment</titte> 

<listRef i^Jame="content#tripLisf ' order="r7> 

< status> svstem#notStarted</ status> 
</item> 
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<itemid="3"> 
<title xml:lang=* W>Pick up Suit</title> 
<listRef idName= "contentiftripList" order="2"/> 
<statns> svstem#notStarted< /statns> 

</item> 

<itemid-'3"> 
< title xml:lang="EN">Work on Resmne<ytifle> 
<listRef idName= "contente^DList" order="l "/> 
< statns> svsteni#inProgress< /statas> 

</itein> 

</myLists> 



With this infonnation, a simple hst display might present this list as: 



SVC Trip, Todo List \ 


Not Started 


Make Dental Appointmentj 


Not Started i 


Pick up Suit 


In Progress] 


Work on Resume ' 



The following table illustrates the structure and contents of a simple "trip" list and a 
shopping Ust for things to purchase or pick up at the mall Note that some elements appear in 
both hsts. Further, note that changeNumbers, creator attributes and other bookkeeping items 
are not included in this example for simpHcity. 



<myLists> 

<Bst idName ^^'tripList" id="l"> 
<title xml:lang="en" dir="ltr">SVC Trip, Todo List</title> 
<listRef i^Same="system#todo'' order="rV> 
<status>system#inProgress</status> 

</list> 

<itemid="2'> 
<title xml:lang="EN">Make Dental Appointment</title> 
<hstRef idName="content#tripList" order-" rV> 
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<status> svstem#notStarted< / status> 
</item> 

<itemid="3"> 
<title xml:lang="EN">Pick up Suit</title> 
<lisiRef idName= "content#trit>List" order="2"/> 
<listRefidName-"system#shopping"order='U"/> 
<stattts> svstein#notStarted< /status> 

</item> 

<itemid="3"> 
<title xml:lang="EN">Work on Resume</title> 
<listRef idName= "content#tripList" order="rV> 
< statns> svstem#inProgress< /stattts> 

</item> 

<itemid-"4"> 
< title xml:lang="EN">Tennis Shoes</title> 
<listRefidName="system#shopping''order="3'V> 
<stattts >notStarted< /status> 

</item> 

<itemid="5"> 
<title xml:lang="EN">Buy a CD</tifle> 
<listRef idName= ='^svsteni#shopping" order="2"/> 
< status> notStarted <statttS> 

</item> 

</inyLists> 



With this information, a simple list display might present these lists as: 



SVC Trip, Todo List \ 


Not Started 


Make Dental Appointmentj 


Not Started 


Pick up Suit 


In Progress 


Work on Resume 
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Shopping 1 


Not Started 


Pick up Suit 1 


Done 


Buy a CD i 


Not Started 


Tennis 1 
Shoes ! 



mvLists / System 

TABLE - myLists / system 

<sys:system> 

: see common system 



<sys:list idName= "..." changeNumber- *. . ." id="..." creator=".,.">o..unbouiided 

<m:cat ref="...">o..unboimded</ni:cat> 
<m:listRefref="..."ordei="...">o..unbounded</m:listRef> 
<m:title xml:lang="..," dir="...">o..unbo«nded</ni:title> 
<m:description xml:lang="..." dir=".,/'>o..unbounded</ni:description> 
<m: status>o., i</m: status> 
{any} 

</sys:list> 

{any} 

</sys:system> 



5 The /system/list (minOccurs=0 maxOccurs=unbounded) element defines a list which 

includes categorization of the list, a localized name for the list, a brief description of the list, 
and any other application specific properties contained within the any block(s). The 
/system/list/@idName (string minOccurs=0 maxOccurs=l) attribute specifies the name of the 
list that can be used in a Hst reference. Note that Ust references are coded as URIs in both 
1 0 absolute, and myLists relative forms. This attribute is the value of the firagment identifier 
firom those URIs. For example, a UstRe£^@ref value of "system#todo" would map to a list 
element whose @idName attribute was todo, and that is located in the system document of the 
myLists service. 
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The /system/list/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
appUcations. Attempts to write this attribute are silently ignored. 

The /system/list/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. 

The /systeni/list/@creator (string minOccurs=0 maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. 

The /system/Ust/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 

The /system/Ust/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute references a 
category definition (<catDef'>) element using the rules outlined in the myCategories section 
above. The /system/list/hstRef (minOccurs=0 maxOccurs=unbounded) element specifies the 
lists that this item is considered contained within. Note that it is vaUd to have a free-form Ust 
item that is not considered to be in part of any list which is why this element is minOccurs=0. 
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The /s)^teiii/list/listRefi'@ref (anyURI ininOccurs=0 maxOccurs=l) attribute contains 
the name of a list element encoded as a URI. The URI follows encoding rules similar to those 
used in cat/catDef linkage: 

system#name-of-list 

The list (definition) being referenced is located in the system document of the .NET 
Lists service, and its list/@idName attribute is "name-of-list". For example, the listiRef of 
<listRef ref="system#todo'V> is a reference to the list definition whose list/@idName value is 
"todo", and that this list definition is located in the system document of the .NET Lists service 
i.e.<list name="todo7>. 

content[?puid=puid-value]#name-of-Ust 

The list definition being referenced is located in the content document of the .NET 
Lists service, and its Ust/@idName attribute is "name-of-hst". The instance of the .NET Lists 
service (i.e., the puid of the service) is implied by the context of the reference. This may be 
made explicit by inserting ?puid=puid-value to the URI, and when this is done, it means the 
content document of the .NET Lists service whose puid is "puid-value" holds the Ust 
definition. For example, the list reference of <hstRef ref="content#bellSqareShopping7> is a 
reference to the hst definition whose hst/@idName value is "bellSquareShopping", and that 
this hst definition is located in the content document of tiie .NET List service for the current 
puid i.e.<Ust name="bellSquareShopping"/>. 

y-uri#name-of-list 

The list definition being referenced is located in an external (to .NET My Services) 
resource. The "any-uri" portion of the reference refers to a resource containing the hst 
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element whose @idName attribute matches the "name-of-Hst". The mapping between the 
"any-uri" portion of the reference and an XML document containing the Ust elements is a 
function of the "any-uri". By convention, this uri is the name of an XML document 
containing those elements. The purpose of this reference form is to allow and support a free 
form set of extended list definitions that are global and available to all. For example, the Ust 
reference of <listRef ref="http://schemas.xyz.com/im/globalLists.xml#xyzStuff"/> is a 
reference to the Hst definition whose hst/@idName value is "xyzStufif", and that this list 
definition is located in an external resource located at 

"http://schemas.xyz.com/im/globalLists.xnil". Note that it is expected that hst defmitions will 
exist in the appropriate locations, but there is no requirement or enforcement of tiiis. 

The /system/list/listRe£'@order (int minOccurs=0 maxOccurs=l) attribute contains an 
optional numeric order for the containing item relative to this hst. Since an item (or even a 
Hst) may logically be contained withm multiple lists, the order of the item is attached to the 
Ust reference so that an item's order can vary based on the Ust that it is contained within. 

The /system/Ust/title (string minOccurs=0 maxOccurs=unbounded) element specifies 
the title of the Ust. The /system/list/title/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. Te /system/list/title/@du: (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the locaUzed string. VaUd values are rtl 
(right to left), and Itr (left to right). 
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The /system/list/description (string minOccurs==0 maxOccurs=unbounded) element 
specifies a more detailed description of the Ust. The /system/list/description/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The /system/hst/description/@dir (string 
minOccurs=0 maxOccurs==l) optional attribute specifies the base direction of directionally 
neutral text. Possible values include rtl (right to left), or Itr (left to right). 

The /system/list/status (anyURI minOccurs=0 maxOccurs=l) contains a status value 
for a Ust the optional status of that list. This elements value is coded as a category reference 
and follows the same rules as found in the usage of cat/@ref. The value may reference a 
category in the myCategories system document, a private status value in the user's 
myCategories content document, or an extemal category definition. It is expected that pre- 
defined system category values in the "system#status" category will be used and this would 
mem that expected values for this element include, system#notStarted, system#inProgress, 
system#completed, system#waiting and system#defered. 

A node select of "//sys:catDef[hs:cat[@ref='system#status']" will locate all definitions 
for system defined status values. 

The /system/Ust/{any} (minOccurs=0 maxOccurs=unbounded) and /system/{any} 
(minOccurs=0 maxOccurs=ainbounded) fields provide extensibility as discussed above. 
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myPresence 

The .NET Presence service (myPresence) provides a generalized framework for clients 
to publish and subscribe to presence infomiation about the endpoint of a specific user, 
wherein a client is any entity that can issue an XMI request to myPresence. The myPresence 
5 service also provides for a way of classifying the information in multiple contexts. Note that 
subscriptions (described above) may be made on endpoints, which will generate a notification 
whenever a change occurs that satisfies the query of the notification. 

An endpoint has no strict semantics within .NET Presence. It is a typology for 
classifying different forms of presence information, but .NET Presence is not aware of the 

j' 

jsl 10 semantics of endpoints, so any restrictions and classifications are outside the scope of the 
A service itself. Some of the potential types of endpoints include instant messaging presence 
ilCf services (e.g., MSN Messenger), device-oriented presence (mobile phones, pagers), physical 
I* location presence (GPS, directory, and so on), and integrated presence (obtained by joining 

j! !sf; 

jisl other endpoints). Again, no semantics are exposed for any of these endpoints at the core level 
Q 15 of .NET Presence. 

The semantics of a given endpoint are exposed through one or more argots. An argot 
identifies a type of domain-specific schema through which the presence of an endpoint is 
represented. Since the presence semantics are entirely contained v^thin argots, consumers of 
presence information can only understand presence information to the extent that they 
20 understand the argots in which that information is represented. In other words, argots are 
tagged blobs of information that applications know how to interpret, at least in part, so as to 
exchange presence-related data, (although a given application may not know anything about a 
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particular argot and will simply not interpret that argot). Note that in an altemative 
implementation, argots may be implemented in tagged "any" fields of XML blobs. 

In general, argots can be appUcation-specific. With an appUcation-specific argot, the 
argot's schema is understood by a Umited set of applications, containing data that is only 
5 meaningful to those applications. Argots can instead be common, wherein the argot's schema 
is known by many applications. Conmion argots contain more generalized presence and 
communications data. An argot can also be integrated, wherein the argot's schema is common 
and expresses information about multiple endpoints. 

FIG. 6 generally represents a structure of an example myPresence schema 600. In 
10 FIG. 6, an Email application program endpoint 602 is expressing Email apphcation program- 

t . 

' J specific data (e.g., which documents a user is working on) in an Email argot 604, while also 

m 

iiy pubhshing presence data in two other schemas, designated by the Presence argot 606 and the 

Q 

" Messenger argot 608. The Messenger argot 608 expresses "Messenger presence" which is 

I* g 

j;!'^ information that a Messenger application can consume, allowing Email apphcation program 

Q 15 to interoperate with the Messenger ^phcation program. The Presence argot 606 is a common 

hi 

argot, and allows a fiirther level of compatibility, in that its schema may be public. Thus, any 
application that understands the Presence argot can understand that level of presence 
information in endpoints that pubUsh that argot. 

Likewise, a Messenger endpoint 612 is using a Messenger argot 614 and a common 
20 Presence argot 616, as well as expressing its data in a standardized (e.g., SIP) argot 618. 

The myPresence service employs the above-described subscription schema to allow 
users of the schema to receive timely updates on changes to presence information. Users of 
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the schema may subscribe to changes on it, and have updates delivered to them as the 
changes. 



mvPresence /Roles 

The myPresence service controls access by usmg the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 

<hs:shape base=t> 

<;/hs:shape> 
<yhs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d"4010-4460-bc34-5094c49cl633> 
<hs:shape base=nil> 

<hs:include select=//*[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 
<hs:shape base=nil> 

<hs:include select=//subscription[@creator=*$callerId']/> 
<hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8C> 
<hs:shape base=nil> 

<hs:include select=//*[cat/@ref=*hs:public']/> 

<hs:includeselect=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 
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The myPresence roleTemplate rtO role gives complete read/write access to the 
infonnation within the content document of the service being protected through this 
roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myPresence service through fliat method while mapped to this 
roleTemplate; 



TABLE - myPresence roleTemplate rtO 



method 


jscope/namej 


Query 


|allElements | 


Insert 


[allElements 


Replacej|allElements 


Delete 


allElements 


Update fallElements ■ 



The myPresence roleTemplate rtl role gives complete read access to all infonnation 
within the content document of the service being protected through this roleTemplate. 
AppUcations mapping to this role also have a limited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that fliey created. The foUowmg table illustrates the available methods and the 
scope in effect when accessing the myPresence service through that method while mapped to 
this roleTemplate: 



{method 


jscope/name ! 


iQuery 


[allElements 


{Insert 


jonlySelfElements 


[Replace 


[onlySelfElements 


Delete 


onlySelfElementsI 
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The myPresence roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myPresence service through that method 
while mapped to this roleTemplate: 

TABLE - myPresence roleTemplate rt2 



method 


|scope/name 


Query 


jallElements 


|hisert 


[onlySelfSubscriptionElementsi 


[replace 


|onlySelfSubscriptionElementsj 


iDelete 


lonlySelfSubscriptionElementSj 



The myPresence roleTemplate rt3 role gives limited read access to information within 
the content docxmient that is categorized as "public." The following table illustrates the 
available methods and the scope in effect when accessing the myPresence service through that 
method while mapped to this roleTemplate: 

myPresence roleTemplate rt3 



method! 


scope/name 


Query j 


onlyPublicElementsi 



The myPresence roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 
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mvPresence / Content 

The content document is an identity centric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
controlled by the associated roleList document. The following table comprises a schema 
5 outline that illustrates the layout and meaning of the information found in the content 
document for the myPresence service: 



<m:myPresence changeNumber -' . . . " instanceld="..." 
xmlns:m="http://schemas.microsoftcoin/hs/2001/10/myPresence" 
xinlns:ma="http://schemas.microsoft.con]/hs/2001/10/myAlerts" 
xnilns:hs="http://schemas.niicrosoft.coin/hs/2001/10/core''>i..i 
<m:endpoiiit name="..." changeNumber= ".„" id="..." creator="...">o..unbounded 
<m:deviceUuid>o..i</m:deYiceUuid> 
<m:expiresAt>o..i</m:expiresAt> 

<m:argot argotURI="..." name="..." changeNumber= "..." id="..." creator=".,.">o. .mbo^ded 
/fl/ij;y</m:argot> 
</m:eiidpomt> 

<m:sabscription changeNuniber="..." id="..." creator="...">o..unbounded 
<hs:trigger select="..." mode="..." baseChangeNumber="...">i..i<;/hs:trigger> 
<hs:expiresAt>o..i</hs:expiresAt> 
<hs:context uri=",..">i .1 /iti/rK/</hs:context> 
<hs:to>i..i</hs:to> 
</m: subscription> 
</m;inyPresence> 

The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
10 underlined type to a red node, as described above, and the minimum and maximum 

occurrence information (0, 1, unbounded) indicates whether an element or attribute is required 
or optional, and how many are possible. 

The/myPresence (minOccurs=l maxOccurs=l) element defines the basic myPresence 
types. The /myPresence/@changeNumber (minOccurs=l maxOccurs=l) changeNumber 
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attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read only to 
apphcations. Attempts to write this attribute are silently ignored. 

The myPresence/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
5 identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a particular service is provisioned for a user. 
The /myPresence/endpoint (minOccurs=0 maxOccurs=unbounded) contains the collection of 
endpoints for this user's .NET Presence service. 

The /myPresence/endpoint/@name (string minOccurs=l maxOccurs=l) is directed to 
i;3 10 an endpoint name, and includes the /myPresence/endpoint/@changeNumber (minOccurs=l 
li? maxOccurs=l) changeNumber attribute, which is designed to facilitate caching of the element 
;;^! and its descendants. This attribute is assigned to this element by the .NET My Services 
U system. The attribute is read only to applications. Attempts to write this attribute are silently 
\U ignored. 

15 The /myPresence/endpoint/@id (minOccurs=l maxOccurs=l) attribute is a globally 

unique ID assigned to this element by .NET My Services. Normally, .NET My Services 
generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. After an ID has been assigned, the attribute is 

20 read only and attempts to write it are silently ignored. 

The /myPresence/endpoint/@creator (minOccurs=l maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformld of the node. The 
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/myPresence/endpoint/deviceUuid (minOccurs^O maxOccurs=l) uuidType is used to specify 
a universally unique identifier (UUE)). (Note that the base type below is probably wrong and 
needs to be fixed to match a correct definition for a UUID.) 

The /myPresence/endpoint/expiresAt (dateTime minOccurs=0 maxOccurs=l) is 
5 directed to when the presence information should expire. The /myPresence/endpoint/argot 
(minOccurs=0 maxOccurs=unbounded) provides a collection of argots for this endpoint. 

The /myPresence/endpoint/argot/@argotURI (anyURI minOccurs=l maxOccurs=l) 
URI points to a location containing the XSD for this argot. It also uniquely identifies the type 
M of argot. 

Q 10 The /myPresence/endpoint/argot/@name (string minOccurs=l maxOccurs=I) includes 

U 

the /myPresence/endpoint/argot/@changeNTimber (minOccurs=l maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 

i y read only to applications. Attempts to write this attribute are silently ignored. 

fy 

1'-^ 15 The /myPresence/endpoint/argot/@id (minOccurs=l maxOccurs=l) attribute is a 

globally unique ID assigned to this element by .NET My Services, Normally, .NET My 
Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Apphcation software can override this DD generation by specifying the 
useCUentlds attribute in the request message. After an ID has been assigned, the attribute is 
20 read only and attempts to write it are silently ignored. The 

/myPresence/endpoint/argot/@creator (minOccurs=l maxOccurs=l) attribute identifies the 
creator in terms of userld, appid, and platformid of the node. 
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V 



The /myPresence/endpoint/argot/{any} (minOccurs=0 maxOccurs=unbounded) 
provides for extensibility. Note that argots in general may be described as XML blobs. 

mvPresence Domain-Specific Methods 

In addition to the standard methods, which operate on this service using the same 
message format and method-interchange techniques described above, the myPresence service 
includes a myPresence/notifyEndpoint domain-specific method. 

Li general, the notifyEndpoint method sends a notification to a specified endpoint, via 
a myPresence/notifyEndpointRequest request message. In response, a response message or a 
SOAP Fault message may be generated. The following sample document outline in the table 
below and accompanying description illustrate the structure and meaning of the elements and 
attributes in the request and response messages: 
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<m:notifyEndpointRequest 
xmlns:m="htlp://schemas.microsoftxoiii/hs/2001/10/my 
xmlns:ma="http://schemas.microsoftxom/hs/2001/10/myAle^^^ 
xmlns:hs="http://schemas.microsoftxom/hs/2001/10/core">i..i 
<m: endpointId>i 1 </m:endpomtId> 
<m:notification id- \..">i..i 
<ma:from>i..i 
<ma:identityHeader type="...''>o..i 
<ma:onBehalfOfUser>i..i</ma:onBehalfOfUser> 
<ma:licenseHolder>i . . i </ma: licenseHolder> 
<ma:platfonnId>i i </ma:platformId> 
</ma:identityHeader> 

<ma:expiresAt ttl="..." onDate="..." replace=".. ">o..i<ma:expiresAt> 
<ma:acknowledge>o . i</ma:acknowledge> 
<nia:category id="...">o.,i</ma:category> 
</ma:from> 
M» <ma:to>o.,i 

1 3 <ma:originaIUsei>o,.i<^a:originaIUser> 

^ 3 </ma:to> 

I * <ma:contents>i .1 /a#9^</ma:contents> 
, ^ <ma:routing>i..i 

1 3 <ma:timestainp>o. j<;/ma:timestan3p> 
j; ;| <ma:hops>o..i</ma:hops> 
!: </ma:routing> 
i= ^ </m:notification> 

li I|</m:notif^^ointRequest> 

f J 

!' * - 

u 

The /notifyEndpointRequest (minOccurs=l maxOccurs=l) method takes an endpoint 
and sends a specified notification to it by means of the endpoint's owner's .NET Alerts. The 
endpoint exposes the notifiableEndpoint argot, so that the .NET Presence service knows 
5 which connection to target in .NET Alerts. This method serves two purposes: first, as an 
abstraction layer over individual connections so that users may target groups of connections 
classified as endpoints. Second, as a privacy measure, so that a specific connection associated 
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with an endpoint may be targeted without that connection being exposed to the user invoking 
the method. 

The ZnotifyEndpointRequest/endpointld (minOccurs=l maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services generates and assigns this ID during an insertRequest operation or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useCHentlds attribute in the request message. After an ID has been assigned, the attribute is 
read only and attempts to write it are silently ignored. 

The notifyEndpointRequest/notification (minOccurs=l maxOccurs=l) is directed to an 
alert. An alert has contents, including "from" (sender) data, optional "to" (receiver) data, and 
optional "routing'* data. The contents are a set of argots (domain-specific blobs). The sender 
and receiver understand and agree on the argots that are transmitted in the alert. In the .NET 
Alerts service, both streams and connections usually choose which alerts they process based 
on the argots contained within the alerts. 

The /notifyEndpointRequest/notification/@id (string minOccurs=0 maxOccurs=l) 
includes the ZnotifyEndpointRequest/notification/from (minOccurs=l maxOccurs=l) tag, 
which contains all data from the sender, including sender authentication as well as preferences 
and requests from the sender. 

The ZnotifyEndpointRequest/notification/from/identityHeader (minOccurs=0 
maxOccurs=l), /notifyEndpointRequest/notification/from/identityHeader/@type (string 
minOccurs=0 maxOccurs=l) and 

/notifyEndpointRequest/notification/from/identityHeader/onBehalfOfUser (minOccurs==l 
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maxOcciirs=l) uuidType is used to specify a universally unique identifier (UUID). 
ZnotifyEndpointRequest/notification/jfrom/identityHeader/licenseHolder (i^^ 
maxOccurs=l). 

The uuidType is used to specify a universally unique identifier (UUID). The 
5 /notifyEndpointRequest/notification/from/identityHeader/platformId(^^ 

maxOccurs=l) uuidType is used to specify a universally unique identifier (UUID). The 
ZnotifyEndpointRequest/notification/froni/expiresAt (string minOccurs=0 maxOccurs=l), 
/notifyEndpointRequest/notification/from/expiresAt/@ttl (string minOccurs=0 
maxOccurs=l), /notifyEndpointRequest/notification/from/expiresAt/@onDate (string 
1:3 1 0 minOccurs=0 maxOccurs=l) /notifyEndpointRequest/notification/fi:om/expiresAt/@replace 
(string minOccurs=0 niaxOccurs=l) are directed to establishing when the presence 
information expires. 

\, JL The /notifyEndpointRequest/notification/from/acknowledge (string minOccurs=0 

lit maxOccurs=l) is directed to acknowledgement to the sender, while 

ry 

p 15 /notifyEndpointRequest/notification/from/category (minOccurs=0 maxOccurs=l) and 

/notifyEndpointRequest/notification/from/category/@id (string minOccurs=0 maxOccurs=l) 
are directed to sender category information. 

The ZnotifyEndpointRequest/notification/to (minOccurs=0 maxOccurs=l) tag contains 
the data pertaining to the receiver. This data can be set by the sender or by any 
20 processing/routing agent between the sender and the receiver. The 

ZnotifyEndpointRequest/notification/to/originalUser (minOccurs=0 maxOccurs=l) element 
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defines the original receiver of the alert. A routing agent may change (forward or fan out) an 
alert to other receivers. If so, it should add this element to the alert. 

The ZnotifyEndpointRequest/notification/contents (minOccurs=l maxOccurs=l) 
element contains the problem domain-specific data to be conveyed to the receiver. Each child 
element of the contents element is an argot, a problem domain-specific strongly-typed XML 
blob. Streams and connections query against the element names of these blobs when selecting 
alerts they will process. Note that argots may be implemented as tagged .NET XML {any} 
blobs. The/notifyEndpointRequest/notification/contents/{any} (minOccurs=0 
maxOccurs=unbounded) provides for notification contents extensibility. 

The ZnotifyEndpointRequest/notification/routing (minOccurs=l maxOccurs=l) tag 
contains any routing data inserted by the .NET Alerts routing process. The 
ZnotifyEndpointRequest/notification/routing/timestamp (string minOccurs=0 maxOccurs=l) 
element contains the timestamp of when the alert was received by the .NET Alerts service. 

The ZnotifyEndpointRequest/notification/routing/hops (string minOccurs=0 
maxOccurs=l) element defines the actors that have processed the alert to date. This data can 
be used by .NET Alerts to recognize and stop infinite loops. 

If the method causes a failure response to be generated, the failure is noted by 
generation of a SOAP Fault message. Failures can include a failure to imderstand a header 
marked as "s:mustUnderstand*', a .NET My Services standard error, security violation, load- 
balance redirect, or any service-specific severe error condition. 
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myPresence / Messenger Argot 

This schema fragment illustrates a sample argot for a basic instant messaging-like 
presence application: 



<m:MessengerArgot status-'..." 
xmhis:m="http://schemas.microsoft.com/hs/2001/10/myPresence" 
xmlns:ma=="http://schemas.microsoft.com/hs/2001/10/myAlerts" 
xmlns :hs=' 'http ://schemas .microsofl.com/hs/200 1/10/ core'^i i 
<m:statusMessage>o„i</m:statusMessage> 

</m:MessengerArgot> 



The /MessengerArgot (minOccurs=l maxOccurs=l) argot represents an instant 
messaging chent's presence. The /MessengerArgot/@status (string minOccurs=l 
maxOccurs=l) contains the present state of the Messenger client. The 
/MessengerArgot/statusMessage (string minOccurs=0 maxOccurs=l) is directed to an 
unrestricted status message reflecting presence. 



myPresence / PresenceArsot 

The following schema fragment and description below illustrate the Presence argot for 
generic representation of presence data: 



<m:PresenceArgot availability^"..." responsiveness-*..." userPreference="..." 
xmhis :m="http ://schemas.microsoft. com/hs/200 1/1 0/myPresence" 
xmlns:ma="http://schemas.microsofl.com/hs/2001/10/myAlerts" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i.,i 

<ym:PresenceArgot> 



15 

The /PresenceArgot (minOccurs=l maxOccxirs=l) argot represent generic presence 
data about an endpoint. The /PresenceArgot/@availabiUty (int minOccurs=l maxOccurs=l) 
attribute indicates how fast and reliable communications are to the endpoint. The 
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/PresenceArgot/@responsiveness (int minOccurs=l maxOccurs=l) attribute indicates how 
quickly the owner of the endpoint is Hkely to respond. 

The /PresenceArgot/@userPreference (int minOccurs=l maxOccurs=l) contains the 
user's preference for this endpoint. This attribute indicates whether this endpoint is the user's 
5 preferred method of contact. 



mvPresence/JConnectableArsot 

The following schema fragment and description below illustrate the Connectable 
argot, which designates one or more connections on the user's .NET Alerts service that are 
□ 10 represented by this endpoint: 



<m:ConnectableArgot 
xmlns:m="http://schemas.microsoft.com/hs/2001/10/myPresence'' 
xmlns:ma="http://schemas.microsoft.com/hs/2001/10/myAlerts" 
xmhis:hs="http://schemas.microsoftxom/hs/2001/10/core">i..i 
<m:connectionE)>i..unbounded</in:connectionID> 

</m:ConnectableArgot> 



The /ConnectableArgot (minOccurs==l maxOccurs=l) argot represents the 
connectability of an endpoint. If present, it designates a connection on the user's .NET Alerts. 
15 The /ConnectableArgot/coimectionlD (minOccurs=l maxOccurs=unbounded) contains the ID 
for one or more connection elements on the user's .NET Alerts that are represented by this 
endpoint. 
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mvProfile 

The myProfile service is designed to store and manage personal profile information 
like name, identification numbers, and picture pointers for the end user. The service is a place 
holder for personal information that is not covered by other personal .NET My Services like 
.NET Address. Between this service, and the .NET Address service, many of the pieces of 
data typically found in an address book entry, or personal profile can be found. 

Each .NET My Services user has one (logical) Profile service document, and each user 
maintains complete control over read and write access to the information contained within that 
profile service document. The user can control visibility of nodes and grant various levels 
access to apphcations and other users based on the role templates. Users can consent to either 
a one-time or continued access, allowing applications to use data fi-om the Profile to pre-fiU a 
form as part of a transaction. 

Users can also direct the Profile service to pubUsh information to one or more .NET 
Contacts service (myContacts) users via a mechanism called LiveContacts. Subscribers view 
this data in the form of a Contact record. The Profile owner chooses what information is 
published to each subscriber role. Once a publisher/subscriber relationship is estabhshed, the 
subscriber's myContact entry for the user's Profile becomes an automatically updated, read 
only Contact record (a "LiveContact"), i.e., any changes made to that Profile will 
automatically be reflected in all subscribers' Contact record. The decision about what 
information gets published to whom is controlled by the owner of the profile through the use 
of roles. In one implementation, the aforementioned service-to-service communications 
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protocol (SSCP) provides a highly efficient, robust mechanism for such automatic updates, 
described below. 



mvProfile / Roles 

The myProfile service controls access by using the rtO, rtl, rt2, rt3 and rt99 
roleTemplates, using the following scopes: 
scope allElements 

<hs:scope id=7215df55-e4af-449f-a8e4-72alf7c6a987> 

<hs:shape base=t> 

</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 
<hs:shape base=nil> 
<hs:include select=//*[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionEIements 

<hs:scope id-b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs:shape base==nil> 
<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9f07e5a5ec8f> 
<hs:shape base=nil> 
<hs:include select=//*[cat/@ref='hs:pubHc']/> 
<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
<yhs:scope> 

The myProfile roleTemplate rtO role gives complete read/write access to the 
information within the content document of the service being protected through this 
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roleTemplate. The following table illustrates the available methods and the scope in effect 
when accessing the myProfile service through that method while mapped to this roleTemplate: 



TABLE - myProfile roleTemplate rtO 



Method { 


scope/name 


Querv 


allElements 


Insert 


allElements 


Replace ; 


allElements ! 


Delete \ 


allElements i 


Update 1 


allElements j 


updateContactMaps 1 


allElements j 


serviceOnline 


allElements \ 


serviceOffline 


allElements 



The myProfile roleTemplate rtl role gives complete read access to all information 
within the content document of the service being protected through this roleTemplate, 
Applications mapping to this role also have a limited ability to write to information in the 
content document. They may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myProfile service through that method while mapped to 
this roleTemplate: 
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TABLE - myProfile roleTemplgjertl 



Method 


scope/name 


Ouerv 


allElements 


Insert j 


onlySelfElementsI 


Replace j 


onlySelfElementsj 


Delete ' 


onlySelfElements i 


updateContactMaps | 


allElements i 


serviceOnline ^ 


allElements 


serviceOffline | 


allElements 



The myProfile roleTemplate rt2 role gives complete read access to the information 
within the content document of the service being protected through this roleTemplate. 
Applications mapping to this role have very limited write access and are only able to create 
and manipulate their own subscription nodes. The following table illustrates the available 
methods and the scope in effect when accessing the myProfile service through that method 
while mapped to this roleTemplate: 



TABLE - myProfile roleTemplate rt2 



method j 


scope/name ! 


Query 


allElements \ 


Insert : 


onlySelfSubscriptionElements j 


replace i 


onlySelfSubscriptionElements j 


Delete 


onlySelfSubscriptionElements i 


updateContactMaps 


allElements 


serviceOnline 


allElements 


serviceOffline 


allElements 



The myProfile roleTemplate rt3 role gives limited read access to information within 
the content document that is categorized as "pubhc." The following table illustrates the 
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available methods and the scope in effect when accessing the myProfile service through that 
method while mapped to this roleTemplate: 



myProfile roleTemplate rt3 



method 


scope/name 


Query 


onlyPublicElements 


updateContactMaps 


allElements ; 


serviceOnline 


allElements j 


serviceOffline 


allElements 



5 



The myProfile roleTemplate rt99 blocks access to the content document. Note that 
lack of a role in the roleList has the same effect as assigning someone to rt99. 



myProfile / Content 

The content document is an identity centric document. Its content and meaning is a 
function of the puid used to address the service. Accessing the document is controlled by the 
associated roleList document. This schema outlined in the following table illustrates the 
layout and meaning of the information found in the content document for the myProfile 
service. 



<m:myProfile changeNumber- instanceld="..." 
xmlns:m="http://schemas.microsoft.com/hs/200 1/1 0/myProfile" 
xmlns:mc="http://schemas.microsoft.com/hs/200 1/1 0/myCalendar" 
xmlns:hs="http://schemas.microsoft.com/hs/2001/10/core">i..i 
<m:name changeNumber= ". . id="..." creator-'.. .">o„unbounded 
<m;cat ref="...''>n .nihnnnHpH< /m:cat > 
<m:title xml:lang="..." dir="...">o..i</m:title> 
<m:givenName xml:lang="..." dir="...">o..i</iTi'givenName> 
<m:middleName xml:lang=''...'' dir=''...''>o..i</m:middleName> 
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<m:sumame xml:lang="..." dir="...">o..i</m:sumame> 
<m:suffix xml:lang="..." dip=",..">o..i</m:suffix> 
<m:fileAsNaine xml:lang="..." dir="../'>o..i</in:fileAsName> 
fany} 

<iii:memberInformation changeNumber=".. " id="... " creator="...">o unbounded 
<m:meinberNamePortion xml:lang="..." dir="...">i..i</m:inemberNamePortion> 
<m:domainNamePortion>i..i</m:domainNamePortion> 

</i]i:memberInfonnatioii> 

<m:languagePreference level="..." changeNumber= "..." id=="..." 

<m:timeZoiiePreference changeNs™ber="..." id="..." creator="...''>o unbounded 

<m;cat rrf="...">o..unbounded</mjcat> 

<m:timeZone>i..i</m:timeZone> 
</m:timeZonePreference> 

<iii:specialDate calendarType="..." changeNumber="..." id=".. " 
ci:eator="...">o..unbounded 

<m:cat ref=". .">o i< /m;cat> 

<m:date>i..i</m:date> 

{any} 
</m:specialDate> 

<m:userReference changeNumber =" . . ^ id- ci^ator^" ••"^o.unbounded 
<hs:name xml:lang="..." dir="...">o..i</hs:name> 
<hs:puid>o..i</hs:puid> 
<hs:email>o.. i</hs :email> 
<hs;cat ref="...''>i„i</hsjcat> 

</m:userReference> 

<m:picture changeNumber ^"../' id="..." creator= ",..">n .»,hn.«.H^ 

<m;cat ref=='\..">n i< /m;cat> 

<m:url>i..i</m:iirl> 

fany} 
</m:picture> 

<m:gender changeNumber- id- creator- '.„">n i</m;^eiider> 
<m:identificationNumber changeNttmber= "..." id="..." creator="...''>o..u„bounded 

<m:cat ref=^..">m< /m;cat > 

<m:number>i„i</m:number> 

(any} 

</m:identificationNumber> 

<m:workInformation changeNumber= "„/' id="..." creator="...">o. .bounded 
<m:cat ref="»/'>o „niv.«nH.H< /m:cat> 
<m:profession xml:lang="..." dir="...">o..i</m:profession> 
<m:jobTitle xml:lang="..;' dir="...">o..i</m:jobTitle> 
<m:officeLocation xml:lang="..," dir="...">o..i</m:officeLocation> 

<m:coworkerOrDepartment>o..unbounded 
<hs:name xTnl:lang="..." dir="...'*>o..i</hs:name> 
<hs:puid>o„i</hs:puid> 
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<hs:email>o..i</hs:email> 
<hs;cat ref="...">i i< /hs;cat > 

</m:coworkerOrDepartment> 

{any} 

<;/m:workIiiformatioii> 
<m:addres$ changeNmnber =' 



<hs:cat ref= 



' id='\.." creator= "...'> 



O..unbounded 



*0.. unbounded 



i</hs:cat> 



<3is:officialAddressLine xml:lang="..;' dir='\.;'>o.a</hs:offi^ 

<hs:intemalAddressLine xml:lang="..." dir="..;'>o..i</hs:intemalAddressLine> 

<hs:primaryCity xml:lang="..." dir="...">o..i</hs:primaryCity> 

<hs:secondaryCity xinl:lang="..." dir="...">o..i</hs:secondaryCity> 

<hs:subdivision xml:lang="..." dii="...">o..i</hs:subdivision> 

<hs:postalCode>o..i</hs:postalCode> 

<hs : country Code>o. . i </hs : coimtry Code> 

<hs:latitude>o..i</hs:latitude> 

<hs:longitude>o..i</hs:longitude> 

<hs:elevation>o..i</hs:elevation> 

<hs:velocity>o..i 

<hs:speed>o..i</hs:speed> 

<hs:direction>o..i</hs:direction> 
</hs:velocity> 

<hs:confidence>o..i<^/hs:confidence> 
<hs:precision>o..i</hs:precision> 
{any} 
</m:address> 

<m:webSite chang^Jumber=="..." id="..." creator-'... ">< 



<m;cat ref="...">o i</iii:cat> 



'O..unbounded 



"id=="„." creator= =-.,»>n 



<ni:url>i,.i</m:url> 
{any} 
</m:webSite> 

<m:emailAddress changeNumber- ' 
<m;cat rM="---">o..unbounded</mjcat> 
<m:email>i..i</m:email> 
<m:name xml:lang="..." dir="...">o..i</m:name> 

</m:emailAddress> 

<m:screenName clmngeNumber=="...'' id="..." ci:eator='\..''>o. i^ibounded 

<m:cat ref="...">n i< /m:cat> 

<m:name xnil:lang="..." dir="...*'>i„i</m:name> 

{any} 
</m:screenName> 

<m:telephoneNumber changeNumber= "..." id="..." creator ="..,">n 
<hs:cat ref='\..''>o..unbounded</Mlcat> 
<hs:countryCode>o..i</hs:countryCode> 
<hs:nationalCode>i.j</hs:nationalCode> 
<hs:number>i^.i</hs:number> 
<hs:numberExtension>o..i</hs:numberExtension> 
<hs:pin>o..i</hs:pin> 
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fatty} 

</m:teIephoneNumber> 

<m:subscription changeNuinber= " . id-"..." creator="...''>o unbounded 

<hs:trigger select-"../' mode-".,." baseChangeNumber-"...">i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri-"...">i.,i /aifvj </hs:contex1> 

<hs:to>i..i</hs:to> 
</m:subscription> 

<m:securityCertificate changeNamber- " id-"..." creator-"... ">o.„rf,oiinded 

<in:cat ^..">o..unbounded</micat> 

<m:certificate>i..i</m:certificate> 
</m:securityCertiflcate> 

<m;myProffle> ^ 

The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum occurrence information 
(0, 1) indicates whether an element or attribute is required or optional, and maximum 
occurrence information (1, unbounded) indicates whether one or many are possible. 

The /myProfile (minOccurs=l maxOccurs-1) element encapsulates the content 
document for this service. This element establishes a global cache scope for the service and 
contains other root-level system attributes for this instance of the service. 

The /myProfile/@changeNumber (minOccurs=0 maxOccurs-1) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 

The /myProfile/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

-372- 



The /myProfile/name (minOccurs=0 maxOccurs=unbounded) element encapsulates a 
name associated with the identity. An identity can have multiple names associated with it. 
These name nodes are not intended to be used for storing screen names or other electronic 
names, but rather to store a commonly used name for the entity. Names contain five parts and 
5 are meant to be combined in proper order, with spaces separating the parts and empty content 
parts excluded. 

The /myProfile/name/@changeNimiber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facihtate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 

U 

□ 1 0 applications. Attempts to write this attribute are silently ignored. 

;f The /myProfile/name/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 

Jf ID assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 

f U Apphcation software can override this ID generation by specifying the useClientlds attribute 

!y. 

^•^15 in the request message. Once an ID is assigned, the attribute is read-only and attempts to write 
it are silently ignored. 

The /myProfile/name/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformid of the node. 

The /myProfile/name/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
20 categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
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definitions, or by referencing an identity centric category definition in the content document of 
the ,NET Categories service for a particular puid. 

The /myProfile/name/ca1/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
5 myCategories section of the present application. 

The /myProfile/name/title (string minOccurs=0 maxOccurs^l) optional element is 
designed to store a title or prefix associated with tiie name. Examples are 'Mr.', *Mrs.% 'Dr.', 
or any other commonly used name title or prefix. The /myProfile/name/title/@xml:lang 
1,^ (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
□ 10 or an ISO 3 166 country code as described in RFC 1766. The vahie of this attribute indicates 

j: C!S 

li the language type of the content within this element. The /myProfile/name/title/@dir (string 

• S i 
"i r ' 

S minC)ccurs=0 maxOcciirs=l) optional attribute specifies the default layout direction for the 

U localized string. Vahd values are rtl (right to left), and Itr (left to right). 

:< ^: 
i s 
•; Kjr 

i'lf The /myProfile/name/givenName (string minOccurs=0 maxOccurs=l) optional 

15 element is meant to store the first portion of a name. The 

/myProfile/name/givenName/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described m RFC 
1766. The value of this attribute indicates tiie language type of the content within this element. 
The /myProfile/name/givenName/@dir (stoig niinOccurs=0 maxOccurs=l) optional attribute 

20 specifies the default layout direction for the locaUzed string. Valid values are rtl (right to left), 
and Itr (left to right). 
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The /myProfile/name/middleName (string minOccurs==0 maxOccurs=l) optional 
element is meant to store the middle portion or initial of a name. The 
/myProfile/name/middleName/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
5 1766. The value of this attribute indicates the language type of the content within this element. 
The /myProfile/name/middleName/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 
: ^ The /myProfile/name/sumame (string minOccurs==0 maxOccurs=l) optional element is 

Q 10 meant to store the last portion of a name. The /myProfile/name/sumame/@xml:lang 

^ (minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 

i:n 
''ft 

J or an ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The /myProfile/name/sumame/@dir 

j y (string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 

ill 

15 the locaUzed string. Valid values are rtl (right to leflf), and Itr (left to right). 

The /myProfile/name/suffix (string minOccurs=0 maxOccurs=l) optional element is 
designed to store a suffix associated with the name. Examples include 7r.', 'Sr.% 'HI', or any 
other commonly used name suffix. The /myProfile/name/suffix/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 

20 country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The /myProfile/name/sufSx/@dir (string 
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minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

A complete name is usually the combination of title, givenName, middleName, 
sumame, and suffix. The /myProfile/name/fileAsName (string minOccurs=0 maxOccurs=l) 
5 optional element is present to indicate that a different order should be used or that the identity 
prefers to have the name filed differently. The /myProfile/name/fileAsName/@xml:lang 
(minOccurs=l maxOccurs==l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 coimtry code as described in RFC 1766. The value of this attribute indicates 
. J the language type of the content within this element. The /myProfile/name/fileAsName/@dir 
Q 10 (string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
%l the localized string. Valid values are rtl (right to left), and Itr (left to right). 

••'■Pi 
U J 

« The /mjlTome/name/fanrt (mmOccurs=0 maxOcoun^bounded) aUows for 

extensibility of the myProfile schema, 
j y The Anj^rofileAnemberinfbrmation (minOccurs=0 maxOccurs=unbounded) node 

Q 15 wraps member-specific public information for this entity. The information is not changeable, 

ji ^ 

which is reflected in the schemas that modify the content document. 

The /myProfile/memberInformation/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
20 read-only to appUcations. Attempts to write this attribute are silently ignored. 

The /myProfile/memberInformation/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
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Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. The /myProfile/memberInfonnation/@creator 
(string minOccurs=0 maxOccurs=l) attribute identifies the creator in terms of userld, appid, 
and platformid of the node. 

A member name is a combination of a user name portion, and a domain name portion. 
These names are separated with an '@' character to form a fully quaUfied member name. The 
/myProfile/memberlnformation/memberNamePortion (string minOccurs=l maxOccurs=l) 
element contains the user name portion of the name. For a fully quaUfied member name of 
someone@microsoft.com, this element contains the value ^someone'. The 
/myProfile/memberInformation/memberNamePortion/@xml:lang(minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3 166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The 

/myProfile/memberInformation/memberNamePortion/@dir (string minOccurs==0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaHzed string. 
Vahd values are rtl (right to left), and Itr (left to right). 

The /myProfile/memberlnformation/domainNamePortion (string minOccurs=l 
maxOccurs=l) field contains the other part of the fully quaUfied member name described 
above, that is, this element contains the domain name portion. For example, for a fiilly 
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qualified member name of someone@microsoft.com, this element contains the value 
'microsoftxom'. 

The /myProfile/languagePreference (string minOccurs=0 maxOccurs=unbounded) 
element specifies the preferred language code of the identity encoded using ISO 639 language 
5 codes or ISO 3 1 66 country codes as defined by RFC 1 766, The purpose of this value in this 
service is to help guide apphcations regarding the languages understood by this identity. 
When manipulating localizable content, they should choose fi-om an appropriate language 
preference. When encountering localized content not falling within this set, the software 
, ^ should translate into a language understood by this set. 

□ 10 The /myProfile/languagePreference/@level (string minOccurs=0 maxOccurs=l) 

%i attribute indicates how well this language is understood by this identity. Valid values inchide, 

tj 5 

native, fluent, intermediate and beginner. 

^3 

i^^^ The /myProfile/languagePreference/@changeNumber (minOccurs=0 maxOccurs=l) 

I y changeNumber attribute is designed to fecihtate caching of the element and its descendants. 
Q 15 This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myProfile/languagePreference/@id (niinOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
20 a replaceRequest. AppUcation software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 
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The /myProfile/languagePreference/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. 

The /myProfile/timeZonePreference (minOccurs=0 maxOccurs=unbounded) element 
supplies the base time-zone preference for this entity. 

The /myProfile/timeZonePreference/@changeNumber (minOccurs=0 ma?cOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to applications. Attempts to write this attribute are silently ignored. 

The /myProfile/timeZonePreference/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myProfile/timeZonePreference/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appId, and platformid of the node. The 
/myProfile/timeZonePreference/cat (minOccurs=0 maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. 
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The /myProfile/timeZonePreference/cat/@ref (anyURI minOccurs=0 maxOccurs=-l) 
attribute references a category definition (<catDe£^) element using the rules outlined in the 
myCategories section of the present application. 

The /myProfile/specialDate (minOccurs=0 maxOccurs=unbounded) element 
encapsulates a special date that is important to this entity. Multiple special date nodes may 
exist. This is not a substitute for dates stored on an entity's myCalendar service. The main 
purpose is to provide a convenient place to store a birth date or an anniversary date, because 
these dates are frequently imported into a contact record. The 

/myProfile/specialDate/@calendarType (string minOccurs=0 maxOccurs=l) field identifies an 
enumeration which determines the kind of calendar event this is based on the following table. 



(which can be expanded): 



Value 


Enumeration Constant 


Description 


-1 


HSCAL_ALL_CALENDARS | 


Unknown Calendar; system default 
(HSCAL_GREGORIAN_US) i 


1 1 


HSCAL GREGORIAN | 


Gregorian (localized) calendar \ 


2 j 


HSCAL GREGORIAN US 


Gregorian (U.S.) calendar i 




HSCAL JAPAN 


Japanese Emperor Era calendar ; 




HSCAL_TAIWAN ; 


Taiwan Era calendar ' 


iP 1 


HSCAL KOREA 


Korean Tangun Era calendar i 


||6 


HSCAL_HURI 1 


Hijri (Arabic Lunar) calendar ! 


|7 


HSCAL THAI 


Thai calendar ; 


Is I 


HSCAL HEBREW 


Hebrew (Lunar) calendar 




HSCAL_GREGORIAN_ME_FRENCH 


Gregorian Middle East French calendar ; 


10 


HSCAL_GREGORIAN_ARABIC 


Gregorian Arabic calendar ' 


11 


HSCAL_GREGORIAN_XLIT_ENGLISH 


Gregorian Transliterated EngUsh 
calendar i 


12 


HSCAL GREGORLW XLIT FRENCH 


Gregorian Transliterated French calendar ' 


13 


HSCAL KOREA LUNAR 


Default Korea Lunar calendar 


14 


HSCAL_JAPAN_LUNAR 


Defauh Japanese Lunar calendar 
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15 ■ 


HSCAL CHINESE LTJNAR 




[16 ; 


HSCAL_SAKA 


Indian Saka calendar ^ 


|17 1 


HSCAL LUNAR ETO CHN ! 


Chinese Zodiac calendar ^ 


|18 


HSCAL LUNAR ETO KOR 


Korean Zodiac calendar 


|19 


HSCAL LUNAR ROKUYOU 


Japanese Lucky days calendar ; 



The /myProfile/specialDate/@changeNiimber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
5 read-only to applications. Attempts to write this attribute are silently ignored. 
i;f The /myProfile/specialDate/@id (minOccurs=0 maxOccurs=l) attribute is a globally 

unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
f n generate and assign this ID during an insertRequest operation, or possibly during a 
Q replaceRequest. Application software can override this ID generation by specifying the 
10 useCUentlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

■' oir 

i!i The /myProfile/specialDate/@creator (string minOccurs=0 maxOccurs=l) attribute 

identifies the creator in terms of userld, appid, and platformid of the node. The 
/myProfile/specialDate/cat (minOccurs=0 maxOccurs=l) element is used to categorize the 
1 5 element that contains it by referencing a global category definition in either the .NET 

Categories service system document or an external resource containing category definitions, 
or by referencing an identity centric category definition in the content document of the .NET 
Categories service for a particular puid. 
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The /myProfile/specialDate/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^>) element using the rules outlined in the 
myCategories section of the present application. 

The /myProfile/specialDate/{any} (minOccurs=0 maxOccurs=unbounded) allows for 
date-related extensibility. 

The /myProfile/userReference/@changeNumber (minOccurs=0 maxOccurs=l) 
changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to appUcations. Attempts to write this attribute are silently ignored. 

The /myProfile/userReference/@id (minOccurs=0 maxOccurs==l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myProfile/userReference/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/myProfile/userReference/name (string minOccurs=0 maxOccurs=l) optional element 
specifies the name for the enclosing element. The /myProfile/userReference/name/@xml:lang 
(minOccurs=l maxOccurs==l) required attribute is used to specify an ISO 639 language code 
or aa ISO 3 166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 
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/myProfile/userReference/name/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
specifies the default layout direction for the localized string. Valid values are rtl (right to left), 
and Itr (left to right). 

The /myProfile/userReference/puid (string minOccurs=0 maxOccurs=l) optional 
element specifies the name for the enclosing element. The /myProfile/userReference/email 
(string minOccurs=0 maxOccurs==l) optional name specifies an email address for the 
enclosing element. The /myProfile/userReference/cat (minOccurs=l maxOccurs=l) element 
is used to categorize the element that contains it by referencing a global category definition in 
either the .NET Categories service system document or an extemal resource containing 
category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. 

The /myProfile/userReference/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
attribute references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present application. 

The /myProfile/userReference/{any} (minOccurs=0 maxOccurs=unbounded) provides 
for extensibility of user-reference related data in the myProfile schema. 

The /myProfile/picture (minOccurs==0 maxOccurs==unbounded) optional element 
encapsulates a URL that points to a picture of the identity. The 

/myProfile/picture/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber attribute is 
designed to facilitate caching of the element and its descendants. This attribute is assigned to 
this element by the .NET My Services system. The attribute is read-only to applications; 
attempts to write this attribute are silently ignored. 
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The /myProfile/picture/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application sofbvare can override this ID generation by specifying the 
5 useCUentlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. 

The /myProfile/picture/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. 
) The /myProfile/picture/cat (minOccurs=0 maxOccurs=l) element is used to categorize 

Q 10 the element that contains it by referencing a global category definition in either the .NET 
''"4 Categories service system document or an external resource containing category definitions, 
or by referencing an identity centric category definition in the content document of the .NET 
Categories service for a particular puid. The /myProfile/picture/cat/@ref (anyURI 
I Ij minOccurs=0 maxOccurs=l) attribute references a category definition (<catDe£'>) element 

1 'si- 

i:3 15 using the rules outUned in the myCategories section of the present application. The 

/myProfile/picture/url (string minOccurs=l maxOccurs=l) element contains the URL that 
points to the actual picture. The /myProfile/picture/{any} (minOccurs=0 
maxOccurs==unbounded) provides for extensibility of picture-related data. 

The /myProfile/gender (siring minOccurs=0 maxOccurs=l) element specifies the 
20 gender for this entity. There can only be a single gender associated with an entity. The format 
of this element is a single, 7-bit ASCn character with one of two possible values: *m' for 
male, and T for female. The /myProfile/gender/@changeNumber (minOccurs=0 
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maxOcciirs=l) changeNumber attribute is designed to facilitate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
attribute is read-only to applications. Attempts to write this attribute are silently ignored. The 
/myProfile/gender/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique ID 
5 assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an inserfRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useCUentlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. The /myProfile/gender/@creator (string minOccurs=0 

5?!; 

ri 10 maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 
%l node. 

li^J The /myProfile/identificationNumber (minOccurs==0 maxOccurs=unbounded) optional 

i'^^^ element encapsulates an identification number for the entity. Things like an employee ID 
fy number, social security number, national ID number, drivers license number, and so on, may 
^3 15 be stored within this element. The /myProfile/identificationNumber/@changeNumber 

(minOccurs=0 maxOccurs=l) changeNumber attribute is designed to facilitate caching of the 
element and its descendants. This attribute is assigned to this element by the .NET My 
Services system. The attribute is read-only to applications. Attempts to write this attribute are 
silently ignored. The /myProfile/identificationNumber/@id (minOccurs=0 maxOccurs=l) 
20 attribute is a globally unique ID assigned to this element by .NET My Services. Normally, 
.NET My Services will generate and assign this ID during an insertRequest operation, or 
possibly during a replaceRequest. AppUcation software can override this ID generation by 
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specifying the useClientlds attribute in the request message. Once an ID is assigned, the 
attribute is read-only and attempts to write it are silently ignored. 

The /myProfile/identificationNmnber/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
/myProfile/identificationNumber/cat (minOccurs=0 maxOccurs=l) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service s}^tem document or an external resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The 

/myProfile/identificationNumber/cat/@ref (anylIRIminOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDef/>) element using the rules outlined in the 
myCategories section of the present appUcation. 

The /myProfile/identificationNumber/number (string minOccurs=l maxOccurs=l) 
element contains the actual identification number value. The 

/myProfile/identificationNumber/{any} (minOccurs=0 maxOccurs=unbounded) provides for 
extensibility. 

The /myProfile/worklnformation (minOccurs=0 maxOccurs=unbounded) element 
encapsulates work-related or occupation-related information for this entity. The 
/myProfile/workInformation/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
appUcations. Attempts to write this attribute are silently ignored. 
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The /myProfile/workInfonnation/@id (minOccurs=0 maxOccurs=l) attribute is a 
globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
Services will generate and assign this K) during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this JD generation by specifying the 
5 useCUentlds attribute in the request message. Once an E) is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myProfile/workInformation/@creator (string minOccurs=0 maxOccurs=l) 
attribute identifies the creator in terms of userld, appid, and platformid of the node. The 
/myProfile/workMormation/cat (minOccurs=0 maxOccurs=^bounded) element is used to 
1:3 10 categorize the element that contains it by referencing a global category definition in either the 

lis 

'2 .NET Categories service system document or an extemal resource containing category 

definitions, or by referencing an identity centric category definition in the content document of 
I J, the .NET Categories service for a particular puid. The /myProfile/workInformation/cat/@ref 
f U (anyURI minOccurs=0 maxOccurs=l) attribiite references a category definition (<catDe£'>) 
;• 3 1 5 element using the rules outlined in the myCategories section of the present application. 

The /myProfile/worklnformation/profession (string minOccurs=0 maxOccurs==l) 
optional element specifies the entity's profession within this particular worklnformation 
element. The /myProfile/workInformation/profession/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
20 country code as described in RFC 1 766. The value of this attribute indicates the language 
type of the content within this element. The /myProfile/workInformation/profession/@dir 
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(string minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for 
the localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myProfile/worklnformation/jobTitle (string minOccurs=0 maxOccurs=l) element 
specifies the job title for this piece of work information. The 
5 /myProfile/workInformation/jobTitle/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myProfile/workInformation/jobTitle/@dir (string minOccurs=0 

I 5^ maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 

□ 10 Valid values are rtl (right to left), and Itr (left to right). 

J The /m>^*rofileAvorkInfbrmation/oflficeI^ (string minOccurs=0 maxOccurs=l) 

element specifies the office location for this piece of work information. The 

■I SJ? 

/myProfile/workInfonnation/officeLocation/@xnil:lang (minOccurs==l maxOccurs=l) 

jIlSB. 

i'lJ required attribute is used to specify an ISO 639 language code or an ISO 3 166 coxmtry code 

f{J 

15 as described in RFC 1766. The value of this attribute indicates the language type of the 

I J. 

content within this element. The /myProfile/workInformation/officeLocation/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myProfile/worklnformation/coworkerOrDepartment (minOccurs=0 
20 maxOccurs=unboxmded) element encapsulates information about this entity's manager, 
assistant, company, department, and so on. The information can include its name, its PUID 
and its email address. Using this anchor information, additional details may be obtained. The 
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required cat element indicates the relationship of the element to this entity (e.g., 
re5="system#manager'*). 

The /myProfile/worklnformation/coworkerOrDepartment/name (string minOccurs=0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 
5 /myProfile/worldnfonnation/coworkerOrDepartment/name/@xml:lang(n^ 

maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 
of the content within this element. The 

/myProfile/workLaformation/coworkerOrDepartment/name/@dir (string minOccurs=0 
Q 10 maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myProfile/worklnformation/coworkerOrDepartment/puid (string minOccurs==0 
maxOccurs=l) optional element specifies the name for the enclosing element. The 

1:3 

f y /m)^fileAvorkInformation^oworkerOrDepa^tme^ (string minOccurs=0 

j' H 

□ 15 maxOccurs=l) optional name specifies an email address for the enclosing element. The 
/myProfile/workhiformation/coworkerOrDepartment/cat (minOccurs=l maxOccurs=l) 
element is used to categorize the element that contains it by referencing a global category 
definition in either the .NET Categories service system docimient or an extemal resource 
containing category definitions, or by referencing an identity centric category definition in the 
20 content document of the .NET Categories service for a particular puid. The 

/myProfile/worldnformation/coworkerOrDepartment/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDe£^>) element using the rules 
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outlined in the myCategories section of the present application. The 
/myProfile/workInfonnation/{any} (niinOccurs=0 maxOccurs=iinbounded) provides for 
extensibility. 

The /myProfile/address (minOccurs=0 maxOccurs=unbounded) element encapsulates 
5 a geographic address. The contained nodes describe the geographic address in detail. Typical 
use is one address element for each geographical address for this identity. For instance, a user 
with a primary home and a vacation home might have two address elements in this service. 
The /myProfile/address/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
q 1 0 assigned to this element by the .NET My Services system. The attribute is read-only to 
%J applications; attempts to write this attribute are silently ignored. 

The /myProfile/address/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Nonndly, .NET My Services will 

•* SJ; 

ry generate and assign this ID during an insertRequest operation, or possibly during a 
i;3 15 replaceRequest. Application software can override this ID generation by specifying the 

useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /myProfile/address/@creator (string minOccurs=0 maxOccurs==l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
20 /myProfile/address/cat (minOccurs=0 maxOccurs=unbounded) element is used to categorize 
the element that contains it by referencing a global category definition in either the .NET 
Categories service system document or an external resource containing category definitions, 
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or by referencing an identity centric category definition in the content document of the ,NET 
Categories service for a particular puid. The /myProfile/address/cat/@ref (anyURI 
minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef/>) element 
Txsing the rules outlined in the myCategories section of the present application. 

The /myProfile/address/officialAddressLine (string minOccurs=0 maxOccurs=l) 
element contains the most precise, official line for the address relative to the postal agency 
servicing the area specified by the city(s)/postalCode. When parsing an address for official 
postal usage, this element contains the official, parsable address line that the regional postal 
system cares about. Typical usage of this element would be to enclose a street address, post 
office box address, private bag, or any other similar official address. Internal routing 
information like department name, suite number within a building, intemal mailstop number, 
or similar properties should be placed within the intemalAddressLine element. The 
/myProfile/address/officialAddressLine/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myProfile/address/officialAddressLine/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
Valid values are rtl (right to left), and Itr (left to right). 

The /myProfile/address/intemalAddressLine (string minOccurs=0 maxOccurs=l) 
element contains intemal routing information relative to the address specified by the 
officialAddressLine. Items like department name, suite number within a building, intemal 
mailstop number, or similar properties should be placed within this element. The 



-391- 



/myProfile/ad<kess/intemalAddressLine/@xml:lang (minOccurs=l maxOccurs-=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myProfile/address/intemalAddressLine/@dir (string niinOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locahzed string. 
VaUd values are rtl (right to left), and Itr (left to right). 

The /myProfile/address/primaryCity (string minOccurs=0 maxOccurs=l) element 
defines the primary city for this address. The /myProfile/address/primaryCity/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 language code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myProfile/address/primaryCity/@dir (string minOccurs=0 maxOccurs=l) optional attribute 
specifies the default layout direction for the locahzed string. Valid values are rtl (right to left), 
and Itr (left to right). 

The /myProfile/address/secondaryCity (string minOccurs=0 maxOccurs=l) optional 
element defines the secondary city for this address. Example types for this element include 
city district, city wards, postal towns, and so on. The 

/myProfile/address/secondaryCity/@xml:lang (minOccurs=l maxOccurs=l) required attribute 
is used to specify an ISO 639 language code or an ISO 3 166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this element. 
The /myProfile/address/secondaryCity/@dir (string minOccurs=0 maxOccurs=l) optional 
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attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 

The /myProfile/address/subdivision (string minOccurs=0 maxOccurs=l) element 
contains the official subdivision name within the coimtry or region for this address. In the 
United States, this element would contain the two letter abbreviation for the name of the state. 
This element is also commonly treated as the "first order admin subdivision" and will 
typically contain subdivision names referring to administrative division, Bundesstaat, canton, 
federal district, province, region, state or territory. The 

/myProfile/address/subdivision/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this element. 
The /myProfile/address/subdivision/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 

The /myProfile/address/postalCode (string minOccurs=0 maxOccurs=l) element 
contains the official postal code for this address. The /myProfile/address/countryCode (string 
minOccurs=0 maxOccurs=l) element contains the 2 letter ISO-3166 id of the country, 
dependency, or functionally equivalent region for this address. The 
/myProfile/address/latitude (string minOccurs=0 maxOccurs=l) element specifies the latitude 
value for this address in units of decimal degrees. Geodetic datum WGS84 is required. The 
/myProfile/address/longitude (string minOccurs=0 maxOccurs=l) element specifies the 
longitude value for this address in units of decimal degrees. Geodetic datum WGS84 is 



-393- 



required. The /myProfile/address/elevation (string niinOccurs=0 maxOccurs=l) element 
specifies the elevation above sea level with respect to WGS84 geodetic datum. The units for 
this value is meters. 

The /myProfile/address/velocity (minOccurs=0 maxOccurs=l) element specifies the 
5 last reported velocity associated with this address. Of course, for fixed addresses the velocity 
node would either not be present, or speed would be zero indication stationary position. The 
/myProfile/address/velocity/speed (string minOccurs=0 maxOccurs=l) element specifies the 
last known speed associated with this report in units of meters per second. The 
I ^ /myProfile/address/velocity/direction (string minOccurs=0 maxOccurs=l) element specifies 
r;3 10 the last known direction associated with this report in units of degrees decimal. The 
;J /myProfile/address/confidence (string minOccurs=0 maxOccurs=l) element specifies a 

j'iTs 
- 

IfJ percentage value that indicates the confidence value that this location is accurate within the 
Specified precision. The /myProfile/address/precision (string minOccurs=0 maxOccurs=l) 

□ 

f y element specifies the precision in meters of this location. The value defines a spherical zone 

Til 

^3 15 that the location falls within. The /myProfile/address/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for address-related extensibiUty. 

The /myProfile/webSite (minOccurs=0 maxOccurs=unbounded) element encapsulates 
an electronic address for this entity, specifically, it contains a web site or URL associated with 
this identity. This element may be repeated any number of times. Typical use is one WebSite 
20 element for each web site associated with this identity. The 

/myProfile/webSite/@changeNumber (minOccurs=0 maxOccxu:s=l) changeNumber attribute 
is designed to faciUtate caching of the element and its descendants. This attribute is assigned 
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to this element by the .NET My Services system. The attribute is read-only to appUcations. 
Attempts to write this attribute are silently ignored. 

The /myProfile/webSite/@id (minOccurs=0 maxOccurs^l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
5 generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
useCUentlds attribute in the request message. Once an ID is assigned, the attribute is read-only 
and attempts to write it are silently ignored. The /myProfile/webSite/@creator (string 

1^ minOccurs=0 maxOccurs=l) attribute identifies the creator in terms of userld, appid, and 

o 

i: 3 1 0 platfbrmid of the node. 

UsSs 

J The /myProfile/webSite/cat (minOccurs=0 maxOccurs=l) element is used to 

categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
fll defmitions, or by referencing an identity centric category definition in the content document of 
O 15 the .NET Categories service for a particular puid. The /myProfile/webSite/cat/@ref (anyURI 

Ms 

minOccurs=0 maxOccurs=l) attribute references a category definition (<catDefi^>) element 
using the rules outlined in the myCategories section of the present application. The 
/myProfile/webSite/url (string minOccurs=l maxOccurs==l) element contains the URL for this 
web site. If the site is accessible through multiple URLs, this element may be repeated an 
20 appropriate number of times. The /myProfile/webSite/{any} (minOccurs==0 
maxOccurs=unbounded) provides for extensibility. 
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The /myProfile/emailAddress (minOccurs=0 maxOccurs=njnbounded) element 
encapsulates an electronic address for this entity, specifically, it contains an email address 
associated with this identity. This element may be repeated any number of times. Typical use 
is one emailAddress element for each email address associated with this identity. The 
5 /myProfile/emailAddress/@changeNumber (minOccurs==0 maxOccurs=l) changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications. Attempts to write this attribute are silently ignored. 
: ^ The /myProfile/emailAddress/@id (minOccurs=0 maxOccurs=l) attribute comprises a 

p 10 globally unique ID assigned to this element by .NET My Services. Normally, .NET My 
>J Services will generate and assign this ID during an insertRequest operation, or possibly during 
a replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
I y only and attempts to write it are silently ignored. The /myProfile/emailAddress/@creator 
Q 15 (string minOccurs==0 maxOccurs=l) attribute identifies the creator in terms of userld, appid, 
and platformid of the node. The /myProfile/emailAddress/cat (minOccurs=0 
maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing a global category definition in either the .NET Categories service system 
document or an extemal resource containing category definitions, or by referencing an identity 
20 centric category definition in the content document of the .NET Categories service for a 

particular puid. The /myProfile/emailAddress/cat/@ref (anyURI minOccurs=0 maxOccurs=l) 
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attribute references a category definition (<catDe£^>) element using the rules outlined in the 
myCategories section of the present application. 

The /myProfile/emailAddress/email (string minOccurs=l maxOccurs=l) element 
contains the actual value of the email address (e.g. someone@microsoft.com). The 
5 /myProfile/emailAddress/name (string minOccurs=0 maxOccurs=l) element contains the 
friendly, or display name associated with this email address. The 

/myProfile/emailAddress/name/@xml:lang (minOccurs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1. 1766. The value of this attribute indicates the language type of the content within this element. 

i;3 1 0 The /myProfile/emailAddress/name/@dir (string minOccurs=0 maxOccurs==l) optional 
'J attribute specifies the default layout direction for the localized string. Valid vahies are rtl 
;:5 (right to left), and Itr (left to right). The /myProfile/email Address/ {any} (minOccurs=0 
ix maxOccurs=imbounded) field allows for extensibility. 

I y The /myProfile/screenName (minOccurs=0 maxOccurs==unbounded) element 

Q 15 encapsulates an electronic address for this entity, specifically, it contains a screen name 

commonly used in real time communications appUcations like instant messaging appUcations, 
chat rooms, and so on. This element may be repeated any nxmiber of times, and the type 
attribute may be used for simple classifications on the screenName. 

The /myProfile/screenName/@changeNumber (minOccurs=0 maxOccurs=l) 
20 changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to appUcations. Attempts to write this attribute are silently ignored. The 
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/myProfile/screenNaine/@id (minOccurs=0 maxOccitrs=l) attribute is a globally unique ID 
assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useClientlds attribute 

5 in the request message. Once an ID is assigned, the attribute is read-only and attempts to 
write it are silently ignored. 

The /myProfile/screenName/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. The 
/myProfile/screenName/cat (minOccurs=0 maxOccurs=l) element is used to categorize the 

1 0 element that contains it by referencing a global category defmition in either the .NET 

Categories service system document or an extemal resource containing category definitions, 
or by referencing an identity centric category definition in the content document of the .NET 
Categories service for a particular puid. The /myProfile/screenName/cat/@ref (anyURI 
minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef/>) element 

1 5 using the rules outlined in the myCategories section of the present application. The 

/myProfile/screenName/name (string minOccurs=l maxOccurs=l) element contains the value 
of the screen name. The /myProfile/screenName/name/@xml:lang (minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language type 

20 of the content within this element. The /myProfile/screenName/name/@dir (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). The 
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/myProfile/screenNaine/{any} (niinOccurs===0 maxOccurs=imbounded) provides for 
extensibility. 

The /myProfile/telephoneNumber (minOccurs=0 maxOccurs=uiibounded) element 
encapsulates an electronic address for this entity, specifically, it contains a telephone number. 
5 This element may be repeated any number of times. Typical use is one telephoneNumber 
element for each phone number associated with this identity. A telephone number is an 
optional country code, a required nationalCode (US area code), a number, an optional 
extension, and an optional pin. 
: ^ The /myProfile/telephoneNumber/@changeNumber (minOccurs=0 maxOccurs=l ) 

Q 10 changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 

m 

•jy 5 

read-only to applications. Attempts to write this attribute are silently ignored. The 
i J, /myProfile/telephoneNumber/@id (minOccurs=0 maxOccurs=l) attribute is a globally unique 
JD assigned to this element by .NET My Services. Normally, .NET My Services will generate 

! '5?? 

[iS 15 and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 

Application software can override this ID generation by specifying the useClientlds attribute 
in the request message. Once an ID is assigned, the attribute is read-only and attempts to write 
it are silently ignored. The /myProfile/telephoneNumber/@creator (string minOccurs=0 
maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platformid of the 
20 node. The /myProfile/telephoneNumber/cat (minOccurs=0 maxOccurs=unbounded) element 
is used to categorize the element that contains it by referencing a global category definition in 
either the .NET Categories service system document or an external resource containing 
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category definitions, or by referencing an identity centric category definition in the content 
document of the .NET Categories service for a particular puid. The 
/myProfile/telephoneNumber/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
references a category definition (<catDe£^>) element using the rules outlined in the 
5 myCategories section of the present application. 

The /myProfile/telephoneNumber/countryCode (string mmOccurs=0 maxOccurs=l) 
optional element specifies the country code for this telephone number. The 
/myProfile/telephoneNumber/nationalCode (string minOccurs=l maxOccurs=l) element 
specifies the national code for this phone number. For US telephone numbers, this is 
Q 10 equivalent to the area code. The /myProfile/telephoneNumber/number (string minOccurs=l 

Ms 

.3 maxOccurs=l) element specifies the actual telephone number within the country and national 
code number scheme. The /rnyProfile/telephoneNumbeiynun^ (string 

U minOccurs=0 maxOccurs=l) optional element specifies an extension used to reach this 

□ 

1 it identity and this number. The /myProfile/telephoneNumber/pin (string minOccurs=0 

i U 

^ 3 15 maxOccurs=l) optional element specifies a pin number used on this phone number. A pin is 
similar to an extension, but pin's are commonly used to address pagers while extensions are 
typically used to address phones relative to a local pbx. The 

/myProfile/telephoneNumber/{any} (minOccurs=0 maxOccurs=ambounded) allows for 
telephone number-related extensibility. 
20 The /myProfile/subscription (minOccurs=0 maxOccurs=unbounded) element defines a 

subscription node as described above in the subscription section. 
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The /myProfile/securityCertificate (minOccurs=0 maxOcciirs=unbounded) node has 
thereunder the /myProfile/seciirityCertificate/@changeNuniber (mniOcciirs=0 maxOccurs=l) 
changeNumber attribute, which is designed to faciUtate caching of the element and its 
descendants. This attribute is assigned to this element by the .NET My Services system. The 
5 attribute is read-only to applications. Attempts to write this attribute are silently ignored. The 
/myProfile/securityCertificate/@id (minOccurs=0 maxOccxirs=l) attribute is a globally unique 
ID assigned to this element by .NET My Services. Normally, .NET My Services will generate 
and assign this ID during an insertRequest operation, or possibly during a replaceRequest. 
Application software can override this ID generation by specifying the useCUentlds attribute 

3 10 in the request message. Once an ID is assigned, the attribute is read-only and attempts to write 

4 it are silently ignored. The /myProfile/securityCertificate/@creator (string minOccurs=0 

n 

5| maxOccurs=l) attribute identifies the creator in terms of userld, appid, and platfbrmid of the 
node. 

The /myProfile/securityCertificate/cat (minOccurs=0 maxOccurs=nmbounded) element 

y 

3 15 is used to categorize the element that contains it by referencing a global category definition in 
either the .NET Categories service system document or an external resource containing 
category definitions, or by referencing an identity centric category definition in the content 
docxmient of the .NET Categories service for a particular puid. The 
/myProfile/securityCertificate/cat/@ref (anyURI minOccurs=0 maxOccurs=l) attribute 
20 references a category definition (<catDe£^) element using the rules outlined in the 

myCategories section of the present application. The /myProfile/securityCertificate/certificate 
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(hexBinary minOcciirs=l maxOcciirs=l) maintains the data, with the /myProfile/{any} 
(minOccurs=0 maxOcciirs=unbounded) providing extensibility. 

5 mvWallet 

The .NET Wallet service, generally referred to as myWallet, is designed to store and 
manage an identity-defined user's financial-related information, such as credit and debit card 
information, bank accoxuit information, and the like, and thus provides an electronic wallet for 
users. To this end, the myWallet service uses an XML schema to describe payment 
i'^ 10 instruments in a user's wallet and the methods by which a payment instrument is stored and 
j i manipulated in the store. The methods and access rights that allow for the manipulation of 

H 

contents in a user's wallet by different role type. 
''"^ For example, in addition to the XML schema for wallet content, the .NET Wallet 

i ^ service provides, imder the user' s control, the ability for data access by a merchant on behalf 
ru 15 of a user. The myWallet service accomplishes this via a query only method for am 
i view the payment instrument to which a user has granted access. As another example, access 
by a financial issuer on behalf of a user is allowed, whereby a financial issuer may manage the 
payment instruments that are issued by this issuer (e.g. the credit card issuer), provided that 
the user has granted the issuer such access right. For example, a financial issuer may manage 
20 certain aspects of wallet content on behalf of a user, such as to update the expiration date of a 
card, change the billing address when a user is moved and notified his or her bank, change the 
bank routing number when the bank is merged, and so forth. 
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To increase security and data privacy, tiie key elements of a wallet (e.g. credit card 
number) may be encrypted using a key or password that only the user knows. By doing so, 
even if a user's account is compromised, the key data in wallet is still protected and non- 
usable. 

The myWallet service is thus directed to payment instrument information, which 
comprises a payment method that the entity will use to pay, including card based payment 
instruments Uke credit cards and debit cards, and account based payment instruments, such as 
traditional checking accounts and savmgs accounts, or any non-traditional account that allows 
a user to accumulate charges and be billed on a regular basis, such as a telephone bill. 

In keeping with the present invention, the .NET Wallet service suppUes such 
information on demand to appropriate .Net-based services, applications or devices. To this 
end, the .NET Wallet service uses .NET My Services to support a rich sharing model based on 
the access control Ust, role m^, and identity header. 

The .NET Wallet service exposes the changeNotify method to be used on the .NET 
Wallet element only. When such an operation occurs on the .NET Wallet with a pending 
changeNotify request outstanding, a notification will be sent to the subscriber via the .NET 
Alerts service. 

mvWallet / Roles 

As with otiier services, the myWallet service controls data access by using the rtO, rtl, 
rt2, rt3 and rt99 roleTemplates, using the following scopes: 
scope allElements 

<hs:scopeid=7215df55-e4af-449f-a8e4-72alf7c6a987> 
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<hs:shape base=t> 
</hs:shape> 
</hs:scope> 

scope onlySelfElements 

<hs:scope id=al59c93d-4010-4460-bc34-5094c49cl633> 

<hs:shape base=nil> 
<hs:mclude select=//*[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlySelfSubscriptionElements 

<hs:scope id=b7f05a6d-75cd-4958-9dfb-f532ebbl7743> 

<hs: shape base=nil> 

<hs:include select=//subscription[@creator='$callerId']/> 

</hs:shape> 
</hs:scope> 

scope onlyPublicElements 

<hs:scope id=da025540-a0c0-470f-adcf-9fD7e5a5ec8fi> 

<hs:shape base=ml> 

<4is:includeselect===//*[cat/@ref='hs:public']/> 

<hs:include select=//subscription[@creator='$callerId']/> 
</hs:shape> 
</hs:scope> 

The myWallet roleTemplate rtO role to gives complete read/write access to 
information within the content document of the service being protected through this 
roleTemplate. The standard methods following table illustrates the available methods and the 
scope in effect when accessing the myWallet service through that method while mapped to 
tiiis roleTemplate: 
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TABLE - my Wallet roIeTempIate rtO 



iTiptlinH 

jllftVl'lllFU 




[query 


allElements ; 


[insert 


allElements | 


replace 


allElements ! 


delete ^ 


allElements J 


update 


allElements ! 



The myWallet roleTemplate role gives complete read access to information within the 
content document of the service being protected through this roleTemplate. Applications 
mapping to this role also have a limited ability to write to information in the content 
document. Applications may create nodes in any location, but may only change/replace, or 
delete nodes that they created. The following table illustrates the available methods and the 
scope in effect when accessing the myWallet service through that method while mapped to 
this roleTemplate: 



|method 


scope/name 


jquery 


allElements 


Ijnsert 


onlySelfElements 


jreplace 


onlySelfElements 


Idelete 


onlySelfElements 



The myWallet roleTemplate rt2 gives complete read access to information within the 
content document of the service being protected through this roleTemplate. Applications 
mapping to this role have very limited write access and are only able to create and manipulate 
their own subscription nodes. The following table illustrates the available methods and the 
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scope in effect when accessing the myWallet service through that method while mapped to 
this roleTemplate: 



TABLE - myWallet roleTempIate rt2 



method] 


scope/name 


query 


allElements 


hisert 


onlySelfSubscriptionElements ; 


[replace 


onlySelfSubscriptionElements; 


j delete 


onlySelfSubscriptionElements: 



5 The myWallet roleTemplate rt3 gives limited read access to information within the 

content document that is categorized as " public." The following table illustrates the available 
9 methods and the scope in effect when accessing the myWallet service through that method 
i 1 while mapped to this roleTemplate: 

i' Yi 

W TABLE - myWaUet roleTemplate rt3 



method 


scope/name i 


[query 


onlyPubUcElements! 



i;3 The myWallet roleTemplate rt99 blocks access to the content document. Note that 

M, 

lack of a role in the roleList has the same effect as assigning someone to rt99. No methods / 
scope are in effect when accessing the myWallet service while mapped to this rt99 
roleTemplate. 

15 

mvWallet I Content 

The content document is an identity caitric document, with its content and meaning a 
function of the user identifier (puid) used to address the service. Accessing the document is 
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controlled by the associated roleList document. The following table comprises a schema 
outline that illustrates the layout and meaning of the information found in the content 
document for the myWallet service: 

TABLE - myWallet / content . 

<m:my Wallet changeNun*CT=" ..." instanceld=" ..." 

xmlns:m=" http://schemas.microsoft.com/hs/2001/10The /myWallet" 
xmlns:hs=" http://schemas.microsoft.com/hs/2001/10/core" >i..i 
<m:card changeNmnber= " ..." id=" ..." creator" ..." >o..unbounded 

<m;cat ref=" ..." >o..unbounded</ffii£M^ 

<m:tvDeOfCard> i i< /m:tvpeOfCard> 

<m!networkBrand> t i< /m:networkBrand> 

<m!affiliateBrand> A i< /m:affiUateBrand> 

<m:cardNumber>i..i</m:cardNumber> 

<m:displayNumber>i..i</m:displayNumber> 

<m:nameOnCardxml:lang=" ..." dir=" ..." >i..i</m:nameOnCard> 

<m:description xml:lang=" ..." dir=" ..." >i..i</m:description> 

<m:expirationDate>o..i</m:expirationDate> 

<m:issueDate>o..i</m:issueDate> 

<m:validFromDate>o..i</m:validFromDate> 

<m:issueNumber>o„i</m:issueNumber> 

<m:currency>i..i 
<m:currencyCode>i ..i</m:currencyCode> 

</m:currency> 

<m:billingAddress>i..i 
<hs:catref=" ..." >o..imbounded</hs:cat> 

<hs:officialAddressLine xmhlang-" ..." dir=" ..." >o..i</hs:officialAddressLme> 

<hs:intemalAddressLine xml:lang=" ..." dir=" ..." >o..i</hs:intemalAddressLine> 

<hs:primaryCity xml:lang=" ..." dir=" ..." >o..i</hs:primaryCity> 

<hs:secondaryCity xml:lang=" ..." dir=" ..." >o..i</hs:secondaryCity> 

<hs:subdivisionxml:lang=" ..." dir=" ..." >o..i</hs:subdivision> 

<hs:postalCode>o..i</hs:postalCode> 

<hs:countryCode>o..i</hs:countryCode> 

<hs:latitude>o..i</hs:latitude> 

<hs:longitude>o..i</hs:longitude> 

<hs:elevation>o..i</hs:elevation> 

<hs:velocity>o..i 

<hs:speed>o..i</hs:speed> 

<hs:direction>o..i</hs:direction> 
</hs:velocity> 

<hs:confidence>o..i</hs:confidence> 
<hs:precision>o..i</hs:precision> 
{any} 
</m:billingAddress> 

<m:paymcntInstrumentsIssuerPuid>Q..i</m:paymentInstrumentsIssuerPuid> 
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</iii:card> 

<Tn!accomit changeNumber- ' ..." id=" ..." creator^ " ..." >o. unbounded 
< m;cat ref=" ..." >o..imbounded</micat> 
<m:tvpeOfAccomit> i i< /m:tvDeOfAccount> 
<m:accoimtRoutingNiunber>o.j<m:accountRoutingNimiber> 
<m:accountNumberxTnl:lang=" ..." dir=" ..." >i..i</m:accountNuniber> 
<m:displayNimiber>i.,i</m:displayNumber> 

<m:nameOnAccountxml:lang=" ..." dir=" ..." >i..i</m:nameOnAccount> 

<m:descriptionxinl:lang=" ..." dir=" ..." >i..i</ni:description> 

<m:currency>i..i 
<m:currencyCode>i..i</ni:currencyCode> 

</m:currency> 
<m:accountAddress>i..i 
<hs:cat ref=" ..." >o..unbomided</hs:cat> 

<hs:officialAddressLine xinl:lang=" ..." dir=" ..." >o..i</hs:officialAddressLme> 

<hs:intemalAddressLinexml:lang=" ..." dir=" ..." >o..i</hs:intemalAddressLine> 

<hs:primaryCity xnil:lang=" ..." dir=" ..." >o..i</hs:primaryCity> 

<hs:secondaryCity xml:lang=" ..." dir=" ..." >o..i</hs:secondaryCity> 

<hs:subdivisionxml:lang=" ..." dir=" ..." >o..i</hs:subdivision> 

<hs:postalCode>o..i</hs:postalCode> 

<hs:countryCode>o..i</hs:countryCode> 

<hs:latitude>o.,i</hs:latitude> 

<hs:longitude>o..i</hs:longitude> 

<hs:elevation>o..i</hs:elevation> 

<hs:velocity>o..i 

<hs:speed>o..i</hs:speed> 

<hs:direction>o..i</hs:direction> 
</hs:velocity> 

<hs:confidence>o..i</hs:confidence> 

<hs:precision>o..i</hs:precision> 

{any} 

</m:accountAddress> 

<m:paymentIns1nimentsIssuerPuid>o.j</m:paymentInsto 

fany} 
</m:account> 

<m:subscriptioii changeNunaber=" ..." id=" ..." creator=" ..." >o..unbounded 

<hs:trigger select=" ..." mode=" ..." baseChangeNumber=" ..." >i..i</hs:trigger> 

<hs:expiresAt>o..i</hs:expiresAt> 

<hs:context uri=" ..." >i..i /aii);;</hs:context> 

<hs:to>i..i</hs:to> 
</m:subscription> 

</m;myWallet> . 
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The meaning of the attributes and elements shown in the table are set forth below, 
wherein in the syntax used in the table, boldface type corresponds to a blue node, and 
underlined type to a red node, as described above, and the minimum and maximum 
occurrence information (0, 1, unbounded) indicates whether an element or attribute is required 
or optional, and how many are possible, as also discussed above. 

The /myWallet (minOccurs=l maxOcciirs=l) node includes a change number 
attribute, /myWallet/@changeNumber (minOccurs=0 maxOccurs=l). The changeNumber 
attribute is designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system. The attribute is read-only to 
applications, with attempts to write this attribute silently ignored, (e.g., without generating an 
error). The /myWallet/@instanceId (string minOccurs=0 maxOccurs=l) attribute is a unique 
identifier typically assigned to the root element of a service. It is a read-only element and 
assigned by the .NET My Services system when a user is provisioned for a particular service. 

The /myWallet/card (minOccurs=0 maxOccurs=unbounded) element encapsulates 
infoimation associated with credit or debit card-like payment instruments. This element 
includes the /myWallet/card/@changeNumber (minOccurs=0 maxOccurs=l) changeNumber 
attribute , designed to facilitate caching of the element and its descendants. This attribute is 
assigned to this element by the .NET My Services system, and is read-only to appUcations. 
Attempts to write this attribute are silently ignored. The /myWallet/card/@id (minOccurs=0 
maxOccurs=l) comprises a globally unique ID assigned to this element by .NET My Services. 
Normally, .NET My Services will generate and assign this ID during an insertRequest 
operation, or possibly during a replaceRequest. Application software can override this ID 
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generation by specifying the useClientlds attribute in the request message. Once an ID is 
assigned, the attribute is read-only and attempts to write it are silently ignored. 

The /myWallet/card/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformid of the node. The /myWallet/card/cat 
5 (minOccurs=0 maxOccurs=unbounded) element is used to categorize the element that 
contains it by referencing a global category definition in either the .NET Categories service 
system document or an extemal resource containing category definitions, or by referencing an 
identity centric category definition in the content document of the .NET Categories service for 
a particular puid. The /myWallet/card/cat/@ref (anyURI minOccurs=0 maxOccurs=l) is an 

;ilO attribute that references a category definition (<catDe£^>) element, using the rules outlined in 
the myCategories section of the present application. 

;S| The /myWallet/card/typeOfCard (string inmOccurs=l maxOccurs=l) is required to 

IS?? 

Store the card type, for example, whether the type is a credit card, a debit card, and so forth. 
'' y Vahd values are defined in an enumeration Ust in the My Wallet schema. The 
-3 15 /myWallet/card/networkBrand (anyURI minOccurs=l maxOccurs=l) element is required, and 
is designed to store a reference to the global or regional/national well recognized and accepted 
card brand, also known as card type. This is to ensure a naming convention among various 
applications and/or services, so that data is usable across these appUcations and/or services. 
Examples are VISA, MasterCard, American Express, Discover, Diners Club, and so forth. 
20 The /myWallet/card/affihateBrand (string minOccurs=0 maxOccurs=l) element is 

optional, and is designed to store the affiliated brand (i.e. sub-brand) or private brand for the 
card. Examples are Carte Bleue (a co-branded VISA debit card used in France), NHL 
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Platinum credit card (a co-branded MasterCard issued by MBNA), and so on. The My Wallet 
service will not restrict the list, but rather lets the application validate and define a list of 
supported cards. 



The /myWallet/card/cardNumber (string minOccurs=l maxOccurs=l) attribute is 
required. The schema includes the following validation rules for Hsted networkBrand types: 



TYPE 


VALIDATION RULES 


VISA 


prefix 4. card# length 16 or 13, Luhn mod 10 check sum 


Mastercard 


prefix 51-55. card# length 16, Luhn mod 10 check sum 


American Express 


prefix 34 or 37, card# length 15, Luhn mod 10 check sum 


Discover 


prefix 60 11, card# length 16, Luhn mod 10 check sum 


Diners Club 


prefix 300-305 or 36 or 38, card# length 14, Luhn mod 10 check sum 


JCB 


prefix 3, card# length 16, Luhn mod 10 check sum 



The /myWallet/card/displayNumber (string minOccurs=l maxOccurs=l) field 
specifies the last four digits of the card number, and is a required, read-only field derived firom 
the card number by the system. The /myWallet/card/nameOnCard (string minOccurs=l 
maxOccurs=l) field stores the card holder's name, and is required. The 
/myWallet/card/nameOnCard/@xml:lang (minOccurs=l maxOccurs=l) attribute is required 
and is used to specify an ISO 639 language code or an ISO 3166 country code as described in 
RFC 1766. The value of this attribute indicates the language type of the content wifliin this 
element. 

The /myWallet/card/nameOnCard/@du- (string minOccurs=0 maxOccurs=l) attribute 
is optional, and specifies the default layout direction for the locahzed siring. VaUd values 
include rtl (right to left), and Itr (left to right). The /myWallet/card/description (string 
minOccurs=l maxOccurs=l) provides a short description for the card for easy referaice (e.g., 
my Bank X Visa, my corporate Amex, and so on). The 
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/myWallet/card/description/@xml:lang (minOccvirs=l maxOccurs=l) required attribute is 
used to specify an ISO 639 language code or an ISO 3166 country code as described in RFC 
1766. The value of this attribute indicates the language type of the content within this 
element. 

5 The /myWallet/card/description/@dir (string minOccuis=0 maxOccurs=l) comprises 

an optional attribute that specifies the default layout direction for tiie locahzed string. Valid 
values are rtl (right to left), and Itr (left to right). The /myWallet/card/expirationDate 
(dateTime minOccurs=0 maxOccurs=l) optionally stores the expiration date of a card, while 
, ^ the /myWallet/card/issueDate (dateTime minOccurs=0 maxOccurs=l) attribute optionally 
r'n 10 stores the date that this card is issued. The /myWallet/card/validFromDate (dateTime 

V-ssh 

' ^1 minOccurs=0 maxOccurs=l) attribute optionally stores the date &om which the card is valid. 

ijfi 

;| Optional. 

f J The /myWallet/card/issueNumber (string minOccurs=0 maxOccurs=l) field stores the 

I' u issue number of the card, used by some types of debit cards, and is optional. The 
Q 1 5 /myWallet/card/currency (minOccurs=0 maxOccurs=l) stores the billing currency of this card, 
and is also optional. The /myWallet/card/currency/currencyCode (string minOccurs=l 
maxOccurs=l) attribute stores the three letter ISO 4217 currency code, e.g., USD (US dollar), 
GBP (United Kingdom pound), and so forth. 

The/myWallet/card/billingAddress (minOccurs=l maxOccurs=l) attribute stores the 
20 billing address of the card, and is required. The /myWallet/card/billingAddress/cat 
(minOccurs=0 maxOccurs=unbounded) element is used to categorize the element that 
contains it by referencing a global category definition in either the .NET Categories service 
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system document or an external resource containing category definitions, or by referencing an 
identity centric category definition in the content document of the .NET Categories service for 
a particular puid. The /myWallet/card/billingAddress/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category definition (<catDef^) element using the rules 
5 ouliined in the myCategories section of the present application. 

The /myWallet/card/billingAddress/ofificialAddressLine (string minOccurs=0 
maxC)ccurs=l) element contains the most precise, official line for the address relative to the 
postal agency servicing the area specified by the city(s)/postalCode. When parsing an address 
U for official postal usage, this element contains the official, parsable address line that the 
3 10 regional postal system cares about. Typical usage of this element includes enclosing a street 
''i address, post office box address, private bag, or any other similar official address. Intemal 
routing information such as department name, suite number within a building, intemal 
mailstop number, or shnilar properties should be placed witMn the mtemaLA.ddressI^ 

i y element. The /myWallet/card/billingAddress/officialAddressLine/@xml:lang (minOccurs=l 

I y 

: 3 1 5 maxOccurs=l) attribute is required, and used to specify an ISO 639 language code or an ISO 

: I 

3166 country code as described in RFC 1766. The value of this attribute indicates the 
language type of the content within tiiis element. 

The /myWallet/card^illingAddress/ofificialAddressLine/@dir (string minOccurs=0 
maxOccurs=l) is an optional attribute that specifies the default layout direction for the 
20 localized string. Valid values are rtl (right to left), and Itr (left to right). The 

/myWallet/card/billingAddress/intemalAddressLine (string minOccurs=0 maxOccurs=l) 
element contains intemal routing information relative to the address specified by the 
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officialAddressLine. Items like department name, suite number within a building, internal 
mailstop number, or similar properties may be placed within tins element. The 
/myWallet/card/billingAddress/intemalAddressLine/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
5 described in RFC 1766. The value of tiiis attribute indicates the language type of the content 
within this element. 

The myWallet/card^illingAdd^ess/intemalAddressLina'@di^ (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
U Valid values are rtl (right to left), and Itr (left to right). The 

P 10 /myWallet/card/billingAddress/primaryCity (string minOccurs=0 maxOccurs=l) element 
/I defines the primary city for this address, while the 

i.| : 
:' ^ 

?| /myWallet/cani^illingAd(kess/^^ (mmOccurs=l maxOccurs=l) 

required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
!l described in RFC 1766. The vaUie of this attribute uidicates tiie language type of the content 
i' f 1 5 within tiiis element. The /myWallet/card/billingAddress/primaryCity/@dir (string 

minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myWallet/card/billingAddress/secondaryCity (string minOccurs=0 
maxOccurs=l) optional element defines the secondary city for this address. Example types 
20 for tiiis element include city district, city wards, postal towns, and so forth. The 

/myWallet/ca^d^illingAddress/seconda^yCity/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 



-414- 



described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myWallet/card^illingAddress/secondaryCity/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myWallet/card/billingAddress/subdivision (string minOccurs=0 maxOccurs=l) 
element contains the official subdivision name within the country or region for this address. 
In the United States, this element would contain the two-letter abbreviation for the name of 
the state. This element is also commonly treated as the "first order admin subdivision'' and 
will typically contain subdivision names referring to administrative division, Bxmdesstaat, 
canton, federal district, province, region, state or territory. The 

/myWallet/card/billingAddress/subdivision/@xml:lang (minOccurs=l maxOccurs=l) is a 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element, while the /myWallet/card^illingAddress/subdivision/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
locahzed string. Valid values are rtl (right to left), and Itr (left to right). The 
/myWallet/card/billingAddress/postalCode (string minOccurs=0 maxOccurs=l) element 
contains the official postal code for this address, while the 

/myWallet/card/billingAddress/countryCode (string minOccurs=0 maxOccurs=l) element 
contains the 2 letter ISO-3166 id of the country, dependency, or functionally equivalent region 
for this address. 
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The /myWallet/card/billingAddress/latitude (string minOccurs==0 maxOccurs=l) 
element specifies the latitude value for this address in units of decimal degrees while the 
/myWallet/card^illingAddress/longitude (string minOccurs=0 maxOccurs=l) element 
specifies the longitude value for this address in units of decimal degrees. The 
/myWallet/card/billingAddress/elevation (string minOccurs==0 maxOccurs=l) element 
specifies the elevation above sea level with respect to WGS84 geodetic datum, in units of 
meters. Geodetic datum WGS84 is required for these elements. The 
/myWallet/card^illingAddress/velocity (minOccurs=0 maxOccurs=l) element specifies the 
last reported velocity associated with this address. Of course for fixed addresses, the velocity 
node would either not be present, or speed would be zero indication stationary position. The 
/myWalletycard^illmgAddress/velocity/speed (string minOccurs=0 maxOccurs=l) element 
specifies the last known speed associated with this report in units of meters per second. The 
/myWallet/card/billingAddress/velocity/direction (string minOccurs=0 maxOccurs=l) element 
specifies the last known direction associated with this report in units of degrees decimal. The 
/myWallet/card/billingAddress/confidence (string minOccurs=0 maxOccurs=l) element 
specifies a percentage value that indicates the confidence value that this location is accurate 
within the specified precision. The /myWallet/card^illingAddress/precision (string 
minOccurs=0 maxOccurs=l) element specifies the precision in meters of this location. The 
value defines a spherical zone that the location falls within. 

The /myWallet/card/billingAddress/{any} (minOccurs^O maxOccurs=unbounded) 
allows an application to store any extended billing address information deemed necessary. 
Future extensions to the schema are thus facilitated and simple to implement. 
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! 

The /myWallet/card/paymentlnstrumentsIssuerPm (string minOccurs=0 

j 

maxOccurs==l) optional element is meant to store Passport ID of the issuer for this card, 
usually a financial institution. 

The /myWallet/card/{any} (minOccurs=0 maxOccurs=ambounded) field type allows 
5 any new type of card information to be stored, whereby future extensions to the schema are 
thus facilitated and simple to implement. 

The /myWallet/account (minOccurs=0 maxOccurs=unbounded) element encapsulates 
information associated with the account-like payment instruments. The account can be a 
u traditional bank account, or, for example, the account can be an account with a service 
Q 10 provider wherein charges to the account are accumulated and billed to the account holder on a 

regular basis, (like phone bills, Ihtemet Service Provider bills, and so forth). 
? 2 The AnyWallet/account/@changeNumber (minOccurs=0 maxOccurs==l) 

1: 4; changeNumber attribute is designed to facilitate caching of the element and its descendants. 

i'U This attribute is assigned to this element by the .NET My Services system. The attribute is 

i'y 

!' ^' 15 read-only to appUcations, and attempts to write this attribute are silently ignored. 

The /myWallet/account/@id (minOccurs=0 maxOccurs=l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Normally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. AppUcation software can override this ID generation by specifying the 
20 useCUentlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 
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The /myWallet/account/@creator (string minOccurs=0 maxOccurs=l) attribute 
identifies the creator in terms of userld, appid, and platformid of the node. 

The /myWallet/account/cat (minOccurs^O maxOccurs=unbounded) element is used to 
categorize the element that contains it by referencing a global category definition in either the 
.NET Categories service system document or an extemal resource containing category 
definitions, or by referencing an identity centric category definition in the content document of 
the .NET Categories service for a particular puid. The /myWallet/account/cat/@ref (anyURI 
minOccurs=0 maxOccurs=l) attribute references a category definition (<catDef/>) element 
using the rules outlined in the myCategories section of the present appUcation. 

The /myWallet/accoxmt/typeOfAccount (string minOccurs=l maxOccurs=l) required 
element is designed to store the account type. Examples include checking, savings, stored 
value account and billToAccount. VaUd values are defined in the enumeration list in the 
schema. 

The /myWallet/account/accountRoutmgNumber (string minOcciu^=0 maxOccurs=l) 
number identifies the issuer of this account in a particular banking system. In the United 
States, it is the ACH routing transit number. Optional, as it is only applicable to traditional 
banking accounts. The /myWallet/accounl/accountNumber (string minOccurs=l 
maxOccurs=l) stores the account number, and is required. The 
/myWallet/account/accountNumber/@xml:lang (minOccurs=l maxOccurs=l) required 
attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. 
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The /myWallet/account/accountNumber/@dir (string minOccurs=0 maxOccurs=l) 
optional attribute specifies the default layout direction for the localized string. Valid values 
are rtl (right to left), and Itr (left to right). The /myWallet/account/displayNuniber (string 
minOccurs=l maxOccurs=l) stores the last four characters or digits of the account number, 
and is required. This will be a read-only field derived from account number by the system. 

The /myWallet/account/nameOnAccount (string minOccvirs=l maxOccurs=l) 
specifies the account holder name. The /myWallet/accounl/nameOnAccount/@xml:lang 
(minOccurs=l maxOccurs^l) is a required attribute is used to specify an ISO 639 language 
code or an ISO 3 166 country code as described in RFC 1766. The value of this athribute 
indicates the language type of the content within this element. The 
/myWallet/account/nameOnAccount/@dir (string minOccurs=0 maxOccurs=l) optional 
attribute specifies the default layout direction for the localized string. Valid values are rtl 
(right to left), and Itr (left to right). 

The /myWallet/account/description (string minOccurs=l maxOccurs=l) provides a 
short description for the account for easy reference (e.g., my Bank X checking), and is 
required. The /myWallet/account/description/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myWallet/account/description/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
Valid values are rtl (right to left), and Itr (left to right). 
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The /myWallet/account/currency (minOccurs=0 maxOccurs=l) field specifies the 
currency of this account. The /myWallet/account/currency/currencyCode (string 
minOccurs=l maxOccurs=l) indicates the three letter ISO 4217 currency code. Examples are 
USD (US dollar), GBP (United Kingdom pound), and so forth. 

The /myWallet/account/accountAddress (minOccurs=l maxOccurs=l) maintains the 
account address. The /myWallet/account/accountAddress/cat (minOccurs=0 
maxOccurs=unbounded) element is used to categorize the element that contains it by 
referencing a global category definition in either the .NET Categories service system 
document or an external resource containing category definitions, or by referencing an identity 
centric category definition in the content document of the .NET Categories service for a 
particular puid. 

The /myWallet/account/accountAddress/cat/@ref (anyURI minOccurs=0 
maxOccurs=l) attribute references a category defmition (<catDe£'>) element using the rules 
outUned in the myCategories section of the present jqjplication. 

The /myWallet/account/accountAddress/officialAddressLine (string minOccurs=0 
maxOcciirs=l) element contains the most precise, official line for the address relative to the 
postal agency servicing the area specified by the city(s)/postalCode. When parsing an address 
for official postal usage, this element contains the official, parsable address line that the 
regional postal system cares about. Typical usage of this element would be to enclose a street 
address, post office box address, private bag, or any other similar official address. Ihtemal 
routing information like department name, suite number within a building, internal mailstop 
number, or similar properties should be placed within the intemalAddressLine element. 
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The/myWallet/accomt/accoimtAddress/officialAddressLine/@xml:lang 
(minOccurs=l maxOccurs=l) required attribute is used to specify an ISO 639 langu^e code 
or an ISO 3166 country code as described in RFC 1766. The value of this attribute indicates 
the language type of the content within this element. The 

/myWallet/account/accountAddress/ofricialA.ddressLine/@dir (string minOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the locaUzed string. 
VaHd values are rtl (right to left), and Itr (left to right). 

The /myWallet/account/accountAddress/intemalAddressLine (string minOccurs=0 
maxOccurs=l) element contains internal routing information relative to the address specified 
by the officialAddressLine. Items like department name, suite number within a building, 
internal mailstop number, or similar properties may be placed within this element. The 
/myWallet/account/accountAddress/intemalAddressLine/@xml:lang(minOccurs=l 
maxOccurs=l) required attribute is used to specify an ISO 639 language code or an ISO 3166 
country code as described in RFC 1766. The value of this attribute indicates the language 
type of the content within this element. The 

/myWallet/account/accountAddress/intemalAddressLine/@dir (string mmOccurs=0 
maxOccurs=l) optional attribute specifies the default layout direction for the localized string. 
VaUd values are rtl (right to left), and Itr (left to right). 

The /myWallet/account/accountAddress/primaryCity (string minOccurs=0 
maxOccurs=l) element defines the primary city for this address. The 
/myWallef account/accoimtAddress/primaryCity/@xml:lang (niinOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3 166 country code as 
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described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myWallet/account/accountAddress/primaryCity/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies the default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). The 
5 /myWallet/account/accountAddress/secondaryCity (string minOccurs=0 maxOccurs=l) 
optional element defines the secondary city for this address. Example types for this element 
include city district, city wards, postal towns, and the like. The 

/myWallet/account/accountAddress/secondaiyCity/@xml:lang (niinOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 

10 described in RFC 1766. The value of this attribute indicates the language type of the content 
within this element. The /myWallet/account/accountAddress/secondaryCity/@dir (string 
mmOccurs=0 maxOccurs=l) optional attribute specifies the default layout dkection for the 
localized string. VaUd values are rtl (right to left), and Itr (left to right). 

The /myWallet/account/accountAddress/subdivision (string minOccurs=0 

15 maxOccurs=l) contains the official subdivision name within the country or region for this 
address. In the United States, this element would contain the two letter abbreviation for the 
name of tiie state. This element is also commonly treated as the " first order admin 
subdivision" and will typically contain subdivision names referring to administrative 
division, Bundesstaat, canton, federal district, province, region, state, territory. The 

20 /myWallet/account/accountAddress/subdivision/@xml:lang (minOccurs=l maxOccurs=l) 
required attribute is used to specify an ISO 639 language code or an ISO 3166 country code as 
described in RFC 1766. The value of this attribute indicates the language type of the content 
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within this element. The /myWallet/account/accountAddress/subdivision/@dir (string 
minOccurs=0 maxOccurs=l) optional attribute specifies tiie default layout direction for the 
localized string. Valid values are rtl (right to left), and Itr (left to right). 

The /myWallet/account/accountAddress/postalCode (string minOccurs=0 
5 maxOccurs=l) element contains ihe official postal code for this address, while the 

/myWallet/account/accountAddress/countryCode (string minOccurs=0 maxOccurs=l) element 
contains the 2 letter ISO-3166 id of the country, dependency, or functionally equivalent region 
for this address. 

1,4 The /myWallet/account/accountAddress/latitude (string minOccurs=0 maxOccurs=l) 

13 10 element specifies the latitude value for this address in units of decimal degrees while the 
li /niyWallet/account/accountAddress/longitude (strmg minOccurs=0 maxOccurs=l) element 
'fZ specifies the longitiide value for this address in units of ded The 

'i ass 

i * /myWallet/account/accountAddress/elevation (string minOccurs==0 maxOccurs=l) element 

f U specifies the elevation above sea level with respect to WGS84 geodetic datum, in units of 

fy 

^ 15 meters. Geodetic datum WGS84 is required for these elements. The 

/myWallet/account/accountAddress/velocity (minOccurs=0 maxOccurs=l) element specifies 
the last reported velocity associated with this address. Of course for fixed addresses, the 
velocity node would either not be present, or speed would be zero indication stationary 
position. The /myWallet/account/accountAddress/velocity/speed (string minOccurs=0 
20 maxOccurs=l) element specifies the last known speed associated with this report in units of 
meters per second. The /myWallet/accoxmt/accountAddress/velocity/direction (string 
minOccurs=0 maxOccurs=l) element specifies the last known direction associated with this 
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report in units of degrees decimal. The /myWallet/account/accountAddress/confidence 
(string minOccurs=0 maxOccvtrs=l) element specifies a percentage value that indicates the 
confidence value that this location is accurate within the specified precision. The 
/myWallet/account/accountAddress/precision (string minOccurs=0 maxOccurs=l) element 
5 specifies the precision in meters of this location. The value defmes a spherical zone that the 
location falls within. 

The /myWallet/account/accountAddress/{any} (minOccurs=0 
maxOccurs=unbounded) field allows for extensibility of the schema with respect to account 
U address information. 

□ 10 The /myWallet/account/paymenthistrumentsIssuerPuid (string minOccurs=0 

J maxOccurs=l) optional element is meant to store the Passport ID of the issuer for this 
••S; account. An issuer for an account can be a fmancial institution for traditional bank accounts, 
1 4^ It can also be a service provider for stored value accounts. 

i U The /myWallet/account/{any} (minOccurs=0 maxOccurs=unbounded) field allows for 

1 5 extensibility of the schema with respect to accounts in general. 

The / myWallet/subscription (minOccurs=0 maxOccurs=unbounded) element defines a 
subscription node as described above in the subscription section. 

mvWallet / System 

20 The system document is a global document for the service, having content and 

meaning that are independent of the puid used to address the service. The document is read 
only to all users. The system document contains a set of base items common to other services 
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in the .NET My Services model, as described above in the common system section of the 

present application, (with myWallet as the *actual service name* to insert) and is extended to 

include service-specific global information by the following: 

This schema outline in the table below illustrates the layout and meaning of the 

5 information for the myWallet service. 

TABLE - myWallet / system 

<sys:system> 

: see common system 

<sys:networkBrand idName=" ..." changeNumber= " ..." id=" ..." creator^ '' ..." >o..unbounded 

<sys:description>i..i</sys:description> 

<sys:brandImageURL>o..i</sys:teandImageURL> 
</sys:networkBrand> 
{any} 

</sys:system> 

The meaning of the attributes and elements shown in the preceding sample document 
outline are Usted below, using the syntax described above for blue (bold) and red nodes 
1 0 (underlined). The common system items are described in the common system documents 
section above. 

The /system/networkBrand (minOccurs=0 maxOccurs=unboxmded) element 
encapsulates the networkBrand information for a payment instrument. 
The /system/networkBrand/@idName (string minOccurs=0 maxOccurs=l) maintains the 
1 5 name, while the /system/networkBrand/@changeNumber (niinOccurs=0 maxOccurs=l) 

changeNumber attribute is designed to facilitate caching of the element and its descendants. 
This attribute is assigned to this element by the .NET My Services system. The attribute is 
read-only to appUcations. Attempts to write this attribute are silently ignored. 
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The /system/networkBrand/@id (minOcciirs=0 maxOccurs^l) attribute is a globally 
unique ID assigned to this element by .NET My Services. Nonnally, .NET My Services will 
generate and assign this ID during an insertRequest operation, or possibly during a 
replaceRequest. Application software can override this ID generation by specifying the 
useClientlds attribute in the request message. Once an ID is assigned, the attribute is read- 
only and attempts to write it are silently ignored. 

The /system/networkBrand/@creator (string minOccurs=0 maxOccurs=l) attribute identifies 
the creator in terms of userld, appid, and platformld of the node. 

The /system/networkBrand/description (string minOccurs=l maxOccurs=l) and 
the /system/networkBrand/brandhnageURL (anylJRI minOccurs=0 maxOccurs=l) are also 
provided to maintain relative financial network brand related information. The /system/ {any} 
(minOccurs=0 maxOccurs=unbounded) provides extensibiUty. 

Service-tO'Service Communications Protocol 

The various .NET MyServices services described above are loosely coupled services, 
and have the ability to share data with each other. It is thus possible for the data to be stored 
and managed by one service, regardless of how many services or applications make use of the 
data. 

Generally, there are at least two ways that this data sharing can take place (assuming 
that appropriate security constraints are satisfied), a first of which is that one service that 
wants data queries another service that has the data, i.e., a pull model. Alternatively, a service 
that wants data can informs the service that has the data to send it the current copy of the data 
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and places an outstanding request to send it any changes to that data. The said changes are 

sent asynchronously. This is a push model. 

The .NET services defines verbs such as query, update, etc., which can be used as a 

basis for the pull data pipe between services. But for reasons of bandwidth optimization and 
5 robustness, the push model turns out to be a better choice for service to service 

communication. To this end, and in accordance with one aspect of the present invention, a 

service-to-service conmiunication protocol (SSCP) is provided that supports a push model of 

data sharing between .NET MyServices services. 
I As used herein, a "publisher"' refers to liie .NET MyServices service which is the 

iii 1 0 source of the data, while a "subscriber" refers to the .NET MyServices service that receives 
''J the data. In general, SSCP is a generic way for a .NET MyServices service to publish data 
I; I changes to another .NET MySarvices service. For example, SSCP does not make any 
U assumptions on what data is being published, and the data may be from any source, e.g., .NET 
! ii Contacts, .NET Profile, .NET Presence, .NET Inbox and so forth. SSCP also does not make 
^ 15 any assumptions on which services can be publishers and which services can be subscribers. 

With SSCP, the same service can be a publisher and subscriber, pubUshers can pubhsh to 

multiple subscribers and subscribers can subscribe to multiple publishers. 

In general, a given service can publish/subscribe to a static list of other services, e.g., 

.NET Contacts (alternatively referred to as myContacts) may be configured with the Ust of 
20 services (e.g., .NET Profile / myProfile, .NET Inbox / myhibox and so on) that it wants to 

publish to and/or subscribe from, and this list will ordinarily not change. However, although 

the services are static, the instances of services are not. For example, once a service A is 



-427- 



i 

configured with the ability to publish or subscribe from service B, service A can do so with 
any instance of B For security reasons and the like, only .NET services can participate in data 
communication over SSCP. 

For purposes of explanation, the present invention will be described with respect to a 
5 number of examples. However, while these examples correspond to likely scenarios and 
implementations, it is understood that the present invention is not limited to the particular 
examples used, but rather works with essentially any service's data communication with 
essentially any other service. 

By way of a first example, consider a scenario of an email whitelist, which is a list of 
Q 10 addresses that are allowed to send email to a particular recipient. Email from people belonging 
iiJ to Ihe whitelist is put in the inbox; all other email is sent to a Junk Mail folder or to the 

jlj deleted folder. Sometimes, the whiteUst of a user is the same as her contact Ust - this would 

ij 

U be the case with the .NET hibox service. Even if this is not the case, it is fairly straightforward 

i:3 

1' IJ to store a whitelist m .NET Contacts by the use of a categorization mechanism present in 

• ; s s 
: s s 

P 15 .NET My Services. 

Using the pull model, a white Ust can be implemented in a brute force fashion by 
arranging the .NET Inbox service (e.g., directly or in conjunction with an application 
program) to look at the sender address whenever a message is received. The .NET Inbox 
service may query the user's .NET Contacts service to see if the sender is in the contact hst, 
20 whereby depending on the result of the query, .NET Inbox service either puts the message in 
the Inbox or puts it in the Junk Mail folder. As can be understood, this approach has obvious 
performance and scahng problems, as it is impractical or impossible for any service that 
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handles hundreds of miUions of email messages every day to use such a model; the sheer 
volume of traffic between .NET Inbox and .NET Contacts would bring down both the 
services. 

hi keeping with the present invention, a superior approach is for the .NET Inbox 
service to maintain a local copy of the whitehst, and subscribe to the .NET Contacts data of 
every user that has enabled a Junk Mail filter. Whenever changes occur to the whitehst, the 
.NET Contacts service uses SSCP to send those changes to the .NET Libox service. Because 
the .NET Labox service has a local copy of the white list, the performance/scaling issues are 
avoided, and any traffic between the .NET hibox service and the .NET Contacts service 
occurs only when the whitehst changes in the .NET Contacts service, the .NET habox service 
subscribes to tiie .NET Contacts service document of a new user (or a user who has newly 
activated her junk mail filters) or the .NET hibox service asks the .NET Contacts service to 
delete the subscription of a currently subscribed user, 

Whitehsts represent a simple pubUsh-subscribe scenario in that user id's of the 
pubhsher and subscriber are the same. There is no requirement to take into account the role of 
the subscriber in the pubhsher's document, the assumption being that the same id plays the 
"owner" role on both sides of this communication channel. A more complex example is that 
of Live Contacts. Among the contacts managed by the .NET Contacts service, it is likely that 
many are users of .NET My Services. As a result, these contacts will have a .NET Profile 
service which manages data in their profile, hi general, the data stored in a contact record of 
.NET Contacts is a subset of what is stored in that contact's profile, the boundaries of the said 
subset being determined by the role of the subscriber in the originating profile's role hst. 
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Thus, it is natural for .NET Contacts service to subscribe to the .NET Profile service to get the 
data for many of the contacts that it manages. From the other perspective, the .NET Profile 
service publishes its data to the .NET Contacts service. 

hi accordance with one aspect of the present invention, because, .NET Profile of this 
5 user publishes any changes to the .NET Contacts service of each appropriately authorized user 
(e.g., in a trusted circle of fiiends), whenever a user updates his profile, such as to change his 
or her email address, that change becomes immediately visible to the users in his or her 
trusted circle when they look up his email via their .NET Contacts service. Note that SSCP 
u works across realms as well as between services in the same reahn, e.g., a subscriber contacts 
□ 10 service in a realm corresponding to MSN.com will be able to receive published changes from 
,1 a publisher profile service in a reaba corresponding to a provider such as XYZ.com, as well as 
); ? from an MSN.com profile service. 

M The present invention favors the push model over the pull model. While the pull 

•SWF 

I y model is usually simpler, its conceivable use is limited to data pipes with low traffic and/or 

Y B 5 

P 15 few subscribers. However, the push model, while a little more involved, provides a bandwidth 
optimized, robust data pipe and is ideal for high-traffic and/or large number of subscribers. To 
ensure robustness in such an aiviromnent of transient network and/or service failures, the 
present invention establishes common message formats, and an accepted set of primitives that 
the parties involved understand, so that transactions among them follow predictable logical 
20 sequences. SSCP also establishes handshaking procedures with ACK to handle lost messages. 

FIG. 5 provides a representation of an example publisher-subscriber relationship. In 
FIG. 5, there are two .NET Profile services 501 and 502, each managing the profiles of three 
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users, 504-506 and 508-510, respectively. There is one instance of a .NET Contacts service 
520 shown in FIG. 5, which manages the contact information sets (521 and 522) of two users. 
As is understood, in an actual implementation, each of these services 501, 502 and 520 will 
typically manage the data for hundreds of millions of users. Note that for each user, access to 
the various contact information sets is on a per-identifier basis, e.g., a contact that is specified 
as a fiiend by a user may be assigned different access rights to the user's contacts than a 
contact that is specified as an associate by the same user. 

As represented by the logical connections (shown in FIG. 5 as arrows) between the 
identity-based contacts and the identify-based profiles, the .NET Contacts service 520 has 
subscriptions in two different .NET Profile services, namely 501 and 502. Similarly, it is 
likely that a given pubUsher will pubUsh to multiple subscribers. Note that a single service 
may act both as a subscriber and a publisher, e.g., in the whitelist example above, the .NET 
Contacts service is a pubhsher, while in tiie Live Contacts example, .NET Contacts service is 
a subscriber. 

As represented in FIG. 5, when the profile information for User6 (maintained in .NET 
Profile 510) changes, change mformation is published by the .NET Profile service2 502 to 
the .NET Contacts service 520, as both Userl and User2 have subscribed for the service. 
Note that in FIG. 5 tiiis is indicated by the arrow to a particular contact for each user. Note 
that withm the context of a given topic, the data flows fi:om the pubUsher to the subscriber. 
As also represented by the arrows in FIG. 5, only User2 has subscribed for profile changes of 
Users. Thus, when UserS's profile is changed, the .NET Profile service 502 will pubUsh the 
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changes only to User2's .NET Contacts , and Userl 's .NET Contacts does not see these 
changes. 

Returning to User6, consider that Userl 's role in User6's .NET Profile is that of an 
associate, while the role of User2 is that of a friend. When .NET Profile publishes the data, it 
5 sends data visible to an associate to Userl , and data visible to a Mend to User2. To this end, 
SSCP sends changes only to subscribed users within a subscribing service, and determines the 
role of each subscribing user and filters the data based on the role. Furthermore, if UserS's 
role was also that of an associate, then only one copy of the associate data would be sent to the 
U subscribing service, thus optimizing usage of netwo± resources. 

^ 3 1 0 In order to accompUsh such selecting data communication and filtering, the publisher 

maintains mfbrmation about the identifier (ID) of the subscribing users, (e.g., Userl, User2). 
Q Also, for each subscribing user, the pubUsher maintains the ID of the user's data for which 
1 * they have subscribed, e.g., for Userl of .NET Contacts , this is User2 and UserS in .NET 

■13" 

lU Profile servicel. The publisher also maintains information regarding the role of the 
J 15 subscribing user, e.g., in the context of User6 in .NET Profile service2, this is associate for 
Userl, friend for User2). 

hi order for the pubhsher to keep this information current, the subscriber notifies the 
publisher whenever one of its users wants to unsubscribe or add a new subscription. For 
example, consider that Userl wants to add User4 into his hve contact list, and remove User6. 
20 SSCP provides for transmission of subscription updates from subscriber to publisher using the 
same robust mechanism as are used for transmitting data changes. 
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The SSCP data pipe is robust and as such, is tolerant of transient network and/or 
service failures. At a fundamental level, to provide robustness, the publisher or subscriber 
needs to know tiiat their transmitted messages have reached the destination, which means that 
each request jfrom a sender should have a response from the receiver. If the message fails to 
reach the receiver, e.g. due to transient network and/or service failure, it is resent during the 
next update interval. This resend process is repeated until a response is received, with a 
specified number of such retries performed, after which no further attempts are made for an 
appropriately longer time to prevent a flood of retry messages, e.g., in the case of a 
catastrophic failure at the destination. 

More subtle types of failures also need to be handled. For example, consider a 
pubUsher sending a request to the subscriber, informing it of the change in a stored profile. 
The subscriber ordinarily receives and processes the request, and sends a response to the 
pubUsher. However, if ttie network connection between the subscriber and the publisher has a 
transient failure and the response fails to reach the publisher, the pubUsher will re-send its 
request it request during the next update interval. In SSCP, the subscriber recognizes that this 
is a redundant request, and that it has akeady been processed, whereby the subscriber 
acknowledges the request again, but does not process it. hi other words, a request is processed 
only once even if it is sent multiple times. Alternatively, a subscriber can process a repeat 
request any nvimber of times, however tiie result of any subsequent processing should not 
change the fnst processing result. This property is referred to as idempotency. 

For efficiency, because a typical service manages enormous amounts of data, 
partitioned over millions of users and the source data wiU be ahnost constantly changing, the 
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protocol batches multiple requests and send them periodically. To this end, a protocol handler 
at the service periodically wakes up after a specified interval and sends the batched messages. 
Moreover, if a catastrophic failure (such as loss of power) occurs, this state data regarding the 
messages to send should not be lost, so data pertaining to protocol state should be stored in a 
5 durable maimer, e.g., persisted to a hard disk. 

As generally represented in FIG. 6, SSCP is implemented at a publisher (service) 600 
and subscriber (service) 610 by respective protocol handlers 602, 612, such as daemon 
processes or the like running with respect to a service. The pubUsher 600 and subscriber 610 
\:A exchange messages, and use this as a mechanism to communicate changes. 
i;3 10 The requirements of the protocol dictate that SSCP handlers 602, 612 maintain several 

y pieces of data, the sum total of which represents the state of a pubUsher or subscriber. As 
I'il conceptually represented in FIG. 6, this data can be viewed as being segmented over several 
j * data structures 604-618. Note however that the arrangements, formats and other description 
W presented herein are only logically represent the schema; the actual storage format is not 
P 1 5 prescribed, and an implementation may store in any fashion it deems fit as long as it logically 
conforms to this schema. 

A pubUsher 600 communicates with a subscriber 610 using request and response 
messages. For example, when data changes at the pubUsher 600, the pubUsher 600, sends a 
request message to the subscriber 610 informing the subscriber that data has changed, 
20 normally along with the new data. The subscriber 6 1 0 receives the message, makes the 
required updates, and sends back an ACK message acknowledging that the message was 
received and that the changes were made. A subscriber 610 can also send a request message. 



-434- 



such as when the subscriber 610 wants to subscribe or \m-subscribe to a piece of datum. When 
the publisher 600 receives this message, tiie publisher 600 updates its list of subscriptions (in 
a publications table 608) and sends back a response acknowledging the request. Note that 
SSCP is agnostic to whether a response message for a given request is synchronous or 
asynchronous. 

Thus, there are two primary parts to SSCP, a first from the publisher to the subscriber, 
which deals with sending changes made to the pubUsher's data, and a second from subscriber 
to the pubUsher, which deals with keepmg the list of subscriptions synchronized. 
Furthermore, every service is required to provide notification to sl\ other services that have 
subscriptions with it, or services with which it has subscriptions, when it is going offline or 
online. 

The table below summarizes request messages, each of which having a corresponding 
response (e.g., ACK) message. 



TABLE 1- REQUEST MESSAGES 



Message 


Description 


Type 


From /To 


UpdateSubscriptionData 


Used by the publisher to publish 
changes to its data 


Request 


Publisher 
to Subscriber 


updateSubscriptionDataResponse 


Used by the subscriber to ACK 
UpdateSubscriptionData 


Response 


Subscriber 
to Publisher 


UpdateSubscriptionMap 


Used by the subscriber to inform 
the publisher that subscriptions 
have been added or deleted 


Request 


Subscriber 
to Publisher 


UpdateSubscriptionMapResponse 


Used by the publisher to ACK 
updateSubscriptionMap 


Response 


Publisher 
to Subscriber 


ServiceStatus 


Used by both publisher and 
subscriber to inform that they 
are going offline, or have come 
online 


Request 


Both 
directions 


Standard .NET My Services ack 


Used by both publisher and 
subscriber to ACK serviceStatus 
request 


Response 


Both 

directions 
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Protocol parameters are supported by both the publisher and the subscriber and control 
the behavior of the protocol. 

As noted above, SSCP supports the ability to batch request messages. Whenever there 
is a need to send a request message, such as when there are changes in publisher data or 
subscriptions, the service puts the corresponding request message into a pubhsher message 
queue 606. Periodically, the protocol handler 602 in the pubUshing service 600 wakes up and 
processes the messages in the queue 606. This period is called as the UpdateLaterval, and is a 
configurable parameter. 

To satisfy the robustness requirement, the pubUsher*s protocol handler 602 needs to 
periodically resend requests until the pubhsher service 600 receives an acknowledge message 
(ACK). If the ACK for a message is successfully received, this message is purged fi-om the 
queue 606. Until then, the message remains in the queue, flagged as having been sent at least 
once, so it will be retried at the next update interval. The number of times the publisher the 
publisher service 600 retries sending a message to the subscriber service 610 is configurable 
by the parameter RetryCount, i.e., after retrying this many times, the publisher service 600 
assumes that the subscriber service 610 is dead. Then, once the maximum number of retries is 
over, the pubhsher service 600 waits for a relatively longer time. Once this longer time is 
elapsed, the pubhsher service 600 sets the RetryCount parameter to zero and begins resending 
the queued up requests over again. This longer time (before beginning the retry cycle), is 
configurable by the parameter Resethiterval. 

Below is the summary of these protocol parameters: 



TABLE 1 - PROTO( 


COL PARAMETERS 




Parameter 


Use 
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Updatelnterval 



The interval after which the protocol handler wakes up and 
processes batched requests. 



RetryCount 



The number of times we retry a connection before assuming the 
remote service is dead. 



Resetlnterval 



The interval after which a service marked as dead is retested for 
aliveness. 



Thus, to implement SSCP, the protocol handlers 602, 610 at the pubUsher and 
subscriber, respectively, track of several pieces of information, such as in their respective 
tables 604-618. 

As with .NET in general, SSCP relies on the entities (services and users) being 
uniquely identifiable by the use of identifiers, e.g., every user in .NET has a unique identifier 
assigned by the Microsoft® Passport service. Each service, be it acting as a publisher or 
subscriber, also has a unique identifier, and in practice, a service ID will be a certificate issued 
by a certification authority. 

Since there are various different kinds of identifiers, the following nammg conventions 

are used herein: 

SID Generic Service Identifier 
PSID Publishing Service Identifier 
SSID Subscribing Service Identifier 

PUID Publishing User Identifier (PUID of myPublishingService user) 
SUID Subscribing User Identifier (PUID of mySubscribingService user) 



To send a request or a response, the service needs to know where the target is located, 
and, to ensure proper handling of the number of retries for a particular service, the handler 
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needs to keep track of how many retries have been done. As mentioned above, this 
infoTmation is kept in the connections table, e.g., the connections table 604 for the publishing 
service 600 and the connections table 614 for the subscribing service 610. The following sets 
forth the information included in a connections table: 



SID TO CLUSTER RETRY 



wherem "SID" comprises the service ID of a Subscriber or Publisher, "TO" comprises the 
URL at which the service is expecting requests comprises, "CLUSTER" comprises the 
cluster number of this service and "RETRY" comprises the current retry number of the 
service. There is one entry in this table for every target service. For apubUsher 600,this 
means for each service that has one or more subscriptions registered with it; for a subscriber, 
this means every publisher that it has one ore more subscriptions with. When RetryCount < 
RETRY < Resetlnterval, the target service is assumed to be dead. Note that when an 
unknown service is recognized (i.e., one that is not present in tiie connections table), an 
attempt is made to contact immediately, without waiting until the next interval. 

As also represented in FIG. 6, a publications table 608 is used by the pubUsher 600 to 
track the users across the services that have subscriptions with it. The pubUcations table 608 
includes records with the following fields: 



PUID 


sum 


SSID ROLE 


CN 



wherein PUID comprises the identifier of the pubUshing user, SUID comprises the identifier 
of the subscribing user, SSID comprises the identifier of the subscribing service, ROLE 
comprises the role assign to this SUID and CN comprises the last known change number of 
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the publisher's data which was delivered to the subscriber (for updating deltas). There is one 
row (record) in the publications table 608 for each subscribing user/publishing 
user/subscribing service combination. The CN field is required to ensure recovery from 
certain catastrophic failures, as described below. The publications table 608 maybe made 
5 visible at the schema level, but ordinarily should be read-only. 

In general, given a pubhshing service P and a subscribing service S, there will exist a 
[possibly empty] set SM = {(PUi, SUi), for i = 1 to n} such that PUi is a user managed by P, 
SUi is a user managed by S, and SUi subscribes to PUi' s data. The set SM is referred to as 

U the subscription map of P with respect to S. The subscription map is obtained by the following 

5^3 10 query: 

'".^ SELECT PUID, SUID 

;:E FROMPUBUCATIONS 

WHERE SSID = S 

U 15 

As further represented in FIG. 6, the publisher 600 includes a publications queue table 
606 that is used by the publisher for batching requests until the protocol handler 602 sends the 
requests when the Updatelnterval time is achieved. The pubUsher also retries requests for 
which a response has not been received, and thus tracks messages that need to be sent for the 
20 first time, or need to be resent, in the publications queue table 606. 
An entry in the table 606 looks like this: 



i'iii 



SUID PUID SSID 



wherein SUID comprises the identifier of the subscribing user, PUID comprises the identifier 
of the pubhshing user, and SSID comprises the identifier of the subscribing service. Note that 
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for practical reasons, the publication queue 606 does not store messages, because a publisher 
services millions of users, whereby at any given instant, the publications queue 606 is likely 
have thousands of entries, and thus the amount of change data may be enormous. Thus, rather 
than storing the change data for each mess^e m the table 608, the publisher 600 uses the 
entries in the queue table 606 to look up the ROLE of the SUE) (from the publications table 
608), and dynamically generates the request message during an update interval. 

Turning to the subscriber service 610, a subscriptions table 618 is used by the 
subscriber 610 to track of its subscriptions that are in effect. An entry in the table 618 looks 
like this: 



SUE) PUDD PSID CN 



wherein SUE) comprises the identifier of the subscribing user, PUE) comprises the identifier 
of the pubUshing user, PSE) comprises the identifier of the pubUshing service, and CN 
comprises the last known change number received from the publisher. Note that the existence 
of a row in this table impHes that the associated publishing service 600 has one or more 
associated entries in its publications table 608. The CN field is required to ensure that 
publisher retries are idempotent. 

When a subscription is added, the subscribing user specifies the PUDD of the user 
whose data he or she wants to subscribe to. For example, if a userl changes a telephone 
number in userl 's profile, user2 can subscribe to see the change in user2's contacts, whereby 
(if user2 is properly authorized) the profile service becomes apublisher of userl's changes 
and the contacts service becomes of subscriber of userl's changes. The subscriber queries 
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.NET Services (myServices) to find out the ID of the publisher (PSID) and stores the 
SUID/PUID/PSID in subscriptions table 618. 

A subscriptions queue table 616 is used by the subscriber 610 to batch its requests for 
sending by the protocol handler 610 whenever the Updatelnterval timer goes off. Also, the 
5 subscriber is required to retry requests for which a response has not been received, and thus 
keeps track of messages that need to be sent for the first time, or need to be resent, which is 
also done in the subscriptions queue table 616. An entry in the table looks like this: 



SUID 


PUID 


PSID 


OPERATION 


GENERATION 



i; 3 wherein SUID comprises the identifier of the subscribing user, PUID comprises the identifier 
H 10 of the pubUshing user, PSID the comprises the identifier of the publishing service, 
% OPERATION comprises the Boolean (TRUE is an addition of a subscription and FALSE is a 
T deletion of a subscription) and GENERATION indicates whether this message is fresh or has 
i;3 been sent one or more times aheady. In one implementation, the subscription queue 616 does 
\ y not store the messages, but ratiier during an update interval, the protocol handler simply looks 
■ 15 at the OPERATION field (which indicates whether this request is to add a subscription or 
delete a subscription) and dynamically generates the appropriate request message. 

As an example of the use of GENERATION, consider a user adding a subscription, 
but deciding to delete it before the pubUsher has responded to the original add request. If the 
addition and deletion h^ened within the same update interval, that is, the add request has 
20 not been sent to the publisher yet, the row can simply be deleted firom the queue 616. 

HowevCT, if the addition happened during a previous update interval, tiie add request was sent 
to the publisher, but an ACK was not received. In this case, the row cannot simply be deleted 
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from the queue, as the pubUsher may have already received the add request and updated its 
subscription map. Thus, a delete request needs to be sent. To send a delete request, the 
OPERATION bit is changed from TRUE to FALSE. Then, when the subscriber sends the 
message again during the next update interval, the publisher simply deletes an added 
subscription. Note that if the publisher did not receive the original add or delete requests, it is 
equivalent to asking it to add an existing row or delete a non-existent row, which is handled 
by the idempotency rules. 

As set forth in TABLEl above, SSCP defines several messages and the responses 

thereof. 

The updateSubscriptionData message is used when a user's document gets modified, 
to send change information to the subscribers. When a document is modified, the publishing 
service 600 checks the contents of the pubhcations table 608 for interested subscribers by 
issuing the following logical query: 

SELECT * FROM PUBLICATIONS 
WHERE PUID=%AFFECTED_PUID% 
GROUP BY SSID, ROLE 

The publisher 600 uses tiie resultant information to create an entry in the queue; the 
said entry records the information necessary to construct an updateSubscriptionData message 
to each affected subscribing service. At the next update interval, for the set of distinct ROLES 
used within the publication queue entries, an associated set of filtered data is created in a 
service- dependent manner. The data is then factored by SSID, and an 
updateSubscriptionData message is created for each affected subscriber and sent, arrives. The 
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message format for updateSubscriptionData follows the following schema using the XMI 
conventions: 



<updateSubscriptionDatatopic="###">l..l 
<\q)dateData publisher="..." 

changeNiunber="###">0..unbounded 
<subscriber>0..unbounded</subscriber> 
<subscriptionData>l .. l</subscriptionData> 
</updateData> 

</updateSubscriptioiiData> 

The data contained in the subscriptionData entity is defined by the participants in the 
service-to-service communication. Services which engage in multiple service-to-service 
communications should use the ©topic attribute to disambiguate the meaning of the content. 
The @topic attribute is a URI and is specific to the instance of service-to-service 
communication. For instance the .NET Profile to .NET Contacts communication could use a 
URI such as "um:microsoft.com:profile-contacts:1.0." No service should attempt to accept an 
updateSubscriptionMap request for any conversation that they have not been explicitly 

configured to accept. 

The format of the response message, updateSubscriptionDataResponse, follows the 

following schema using the XMI conventions: 



<updateSubscriptionDataResponse topic="###">l . . 1 
<updatedDatapublisher="...">0..unbounded 

<subscriber>0..unbounded<;/subscriber> 

</updatedData> 

<deleteFromSubscriptionMap subscriber="..." />0.. unbounded 
•</updateSubscriptionDataResponse> ^ 
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The function of <updatedData> is to inform the publisher, while the 
<deleteFromSubscriptionMap> is used by the subscriber to tell the publisher that this SUID 
has been deleted, as described below. Note that if a response is received for data that is not 
subscribed, an immediate delete may handle such a response. 

The updateSubscriptionMap message is used when a set of one or more users changes 
their subscription status(es). When this occurs, the set of changes are sent to the affected 
publishers within an updateSubscriptionMap message. When the pubhsher receives this 
message it updates the records in the publications table 608. It is not an error to add an entry 
more than once, nor to delete a non-existent entry. In both these cases the response is 
formatted so that success is indicated. This is required to ensure that retries are idempotent. 

The request message format for updateSubscriptionMap follows the following schema 
using the XMI conventions: 

<updateSubscriptionMap topic- '###">!.. 1 

<addToSubscriptionMap subscriber^". . .">0. .unbounded 

<publisher>0..unbounded</pubhsher> 
</addToSubscriptionMap> 

<deleteFromSubscriptionMap subscriber=",..">0..unbounded 

<publisher>0..unbounded<pubUsher> 
</deleteFromSubscriptionMap> 
</updateSubscriptionMap> 

The addToSubscriptionMap section is used to make additions to the subscriptionMap, 
while the deletePromSubscriptionMap removes entries. 

The response message for updateSubscriptionMapResponse is formatted according to 
the following schema using the XMI conventions: 
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<updateSubscriptionMapResponse topic="###">l .. 1 

<addedToSubscriptionMap subscriber="...">0..unbounded 

<publisher>0..iinbounded</publisher> 
</addedToSubscriptionMap> 

<deletedFromSubscriptionMap subscriber="...">0..unboimded 

<publisher>0..unbounded</publisher> 
</delete(lFromSubscriptionMj^> 
<imknownPID publisher="..." />0.. unbounded 
</updateSubscriptionMapResponse> 

The <addedToSubscriptionMap> and <deletedFromSubscriptionMap> provide status 
information, while the entity <un]aiownPK)> is used in situations where a publishing user is 
deleted. 

Services also need to send out messages when they come on-line, e.g., to wake up 
other services which have stopped sending them messages. To this end, whenever a service is 
going offline or coming online, the service should send out the following message to its 
partner services stored in its connections table (604 if apubhsher, 614 if a subscriber, 
although it is understood that a service may be both a publisher and a subscriber and thus 
access both tables at such a time time). The format of this message using the XMI conventions 



<serviceStatus> 1 . . 1 
<online/>0..1 
<offline/>0..1 

</serviceStatus> 

Only one of the online or offline entities should be sent in any given message. 
There is no defined response format for this message, as the normal .NET My Services 
ACK or fault response supplies the mformation needed. 
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By way of explanation of the operation of SSCP, a protocol handler wakes up when 
the interval timer goes off, whereby the handler sends the queued up requests, or when a 
request is received from another service, whereby the handler performs the requested action 
and sends a response. 

For purposes of this explanation of SSCP, a "Live Contacts" example, as generally 
discussed above, will be used herein. In the example, generally represented in FIG. 7, three 
.NET Profile services, having IDs ofPSIDi,PSID2, and PSID3, will be described. PSIDi 
contains the profile documents of three users, namely PUTDn, PUID12, and PIJID13; PSID2 
contains profile documents of two users: PUID21 and PUID22; and PSID3 contains profile 
docimients of two users: PUID31 and PUID32. There are two .NET Contacts services whose 
IDs are SSIDl and SSID2, wherein SSIDl manages contact documents of three users, SUIDiu 
SUID12, and SUID13, and SSID2 manages contact documents of two users SUID21 and 
SUID22. 

Consider an initial subscription map, generally represented in FIG. 7, indicating with 
respect to PSIDi: 

PUIDn: fiiend(SUIDn), associate(SUIDi2) 

PUID12: other(SUID2i) 

PUID13: 
with respect to PSID2: 

PUID2i:lTiend(SUIDii) 

PUID22: fnend(SUID2i,SUID22), associate(SUIDi2) 



-446- 



and with respect to PSE)3: 

PUID31: associate(SUIDn), other(SUE)i3) 

PUE)32: friend(SUn)2i), associate(SUID22) 
and also indicating with respect to SSIDi: 

SUIDii: PUIDii, PUID21, PUID31 

SUn)i2: PTJlDn, PUID22 

SUID13: PUID31 
and with respect to SSID2: 

SUID21: PUID12, PUID22, PUID32 

SUID22: PUID22, PUID32 



As described above, for the example data, the two contacts services each include a 
connections table. For SSIDi this table (with included information such as cluster and URL 
omitted for simplicity) looks like: 



SSIDi CONNECTIONS Table 




PSIDi 




PSID2 




PSID3 



while for SSID2 the connections table looks like: 



SAID2 CONNECTIONS Table 




PSE), 




PSID2 




PSID3 
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As described above, in addition, the three profile services each contain a publications 
table. For PSIDi this table (with included information such as change number omitted for 
simplicity) looks like: 



PSIDi PI 


LJBLICATIONS Table 


PUIDii 


SUIDii 


SSIDi 


Mend 


PUIDii 


SUID12 


SSIDi 


associate 


PUID12 


SUID21 


SSID2 


other 



5 which for PSID2 looks like: 



PSID2 PUBLICATIONS Table 


PUID21 


SUIDii 


SSIDi 


friend 


PUID22 


SUID12 


SSIDi 


associate 


PUID22 


SUID21 


SSID2 


friend 


PUID22 


SUID22 


SSID2 


fiiend 



CO and for PSID3 this looks Uke: 



PSID3 PI 


LJBLICATIONS Table 


PUID31 


SUIDii 


SSIDi 


associate 


PUID31 


SUID13 


SSIDi 


other 


PUID32 


SUID21 


SSID2 


fiiend 


PUID32 


SUID22 


SSID2 


associate 



If during an update interval on SSIDi, the user SUIDn adds links to PUID12 and 
10 PUID32 and deletes the link fi-om PUIDn, while SUID12 deletes the link to PLTEDi 1 the 
contents of the subscriptions queue for SSIDi is: 



SSIDi SUBSCRIPTIONS_ 


QUEUE 


SUIDii 


PUID12 


PSIDi 


TRUE 


0 


SUIDii 


PUID32 


PSID3 


TRUE 


0 


SUIDn 


PUIDn 


psroi 


FALSE 


0 


StnDi2 


PUIDn 


PSIDi 


FALSE 


0 
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When processed, this table will generate two different updateSubscriptionMap 
requests that are sent to the two affected .NET Profile services. 
PSIDi is sent: 



<updateSubscriptionMap topic="####"> 

<addToSubscriptionMap subscriber="SUIDi i"> 

<publisher>PU]Di2</publisher> 
</addToSubscriptionMap> 
<deleteFroniSubscriptionMap subscriber='*SUIDi i"> 

<publisher>PUE)i i<;/publisher> 
</deleteFromSubscriptionMap> 
<deleteFromSubscriptionMap subscriber^"SUIDi2"> 

<publisher>PUIDi i</publisher> 
</deleteFromSUbscriptionMap> 
<updateSubscriptionMap> 

a nd PSID3 is sent: 

<updateSubscriptionMap topic="####''> 

<addToSubscriptionMap subscriber="SUIDii"> 

<publisher>PUE)32</publisher> 
<yaddToSubscriptionMap> 
</updateSubscriptionMap> 



After receiving these messages, each .NET Profile service updates the contents of 
their publications table as follows (with the CN change number column omitted). 
For PSIDi, the resulting table looks like: 



PSIDi PUBLICAN 


IONS Table 


PUID,2 


SUID21 


SSE)2 


Other 


PUID12 


SUIDii 


SSIDi 


associate 



and for PSIDa, the resulting table looks like: 



PSID3 PUBLICATIONS Table 


PUID31 


SUIDu 


SSIDi 


associate 
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PUIDsi 


SUIDb 


SSIDi 


Other 


PUID32 


SUIDii 


SSIDi 


Other 


PUID32 


SUID21 


SSID2 


Friend 


PUE>32 


SUID22 


SSID2 


associate 



Based on the original configuration, PUXDu changes the contents on its profile, 
whereby PSn)i constructs the following updateSubscriptionData message to SSIDi: 



<updateSubscriptionData topic="####"> 

<updateDatapublisher="PUIDii" changeNuniber="###"> 

<subscriber>SUIDi i</subscriber> 

<subscriptionData>friend-info</subscriptionData> 
</updateData> 

<updateDatapublisher="PUIDii" changeNumber="###"> 
<subscriber>SlJn)i2</subscriber> 
<subscriptionData>associate-info</subscriptionData> 

</updateData> 

</updateSubscriptionData> 

Note that the message is spUt between two updateData blocks because of different 
roles being assigned. If PUID22 were to change their profile information this would result in 
PSID2 sending out two updateSubscriptionData messages to SSIDi and SSID2. 
The message to SSIDi: 



<updateSubscriptionData topic="####"> 

<updateData pubUsher='TlJID22" changeNumber="###"> 
<subscriber>SUIDi2</subscriber> 
<profileData>associate-information</profileData> 

<yupdateData> 

<yupdateSubscriptionData> 

The message to SSID2: 
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<updateSubscriptioiiData topic="####"> 

<updateData publisher="PUn)22" changeNumbei="###"> 
<subscriber>SUID2i</subscriber> 
<subscriber>SUID22</subscriber> 
<profileData>fiiend-information</profileData> 

<updateData> 

</updateSubscriptioiiData> ^ . 

Note in this case, the message to SSID2 only contains one copy of the data optimizing 
for identical roles. 

Thus, as demonstrated above, and in accordance with one aspect of the present 
invention, the amount of information that is transmitted from one sendee to another is 
significantly reduced in SSCP because the change information for one user at a pubUsher 
service that is subscribed to by multiple users at a subscriber service who are assigned the 
same role at the publishing service, are aggregated into a single message. In other words, the 
publisher operates in a fan-in model to put change information together based on their roles, 
rather than separate it per user recipient, and leaves it up to the subscriber to fan the 
information out to the appropriate users. By way of example, a user may change his profile to 
reflect a new telephone number, address, occupation and so forth;, , based on what they are 
authorized to see, e.g., as fiiends (who can see all such changes) or associates (who can only 
see telephone number and occupation changes), SSCP constructs a message with one copy of 
the friends data and one copy of the associates data, and sends this message to the subscriber. 
The impUcit assumption in this description is that all the subscribers reside on the same 
service. Should any of the subscribers reside on a different service, a separate message will be 
sent to that service, following the same aggregation principles outlined above. 
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SSCP is a robust protocol which is able to handle many different kinds of failure 
scenarios, including when the pubUsher fails, the subscriber fails, the link between publisher 
and subscriber goes down before the subscriber can respond (after it has received a request), 
the link between publisher and subscriber goes down before the publisher can respond (after it 
5 has received a request), the publisher loses the subscription m^, and the subscriber loses 
published data. In general, these failure scenarios are handled by message retries and 
idempotency, as generally described below. 

Message retries will be described with respect to an example that assumes the 
publisher sends the request message. However the message-retry mechanism applies equally 
10 well when the subscriber sends the retry message. When the publisher sends a request 
message, the publisher sends the message from the pubHcations queue and waits for a 
1:3 response to this message. If the pubUsher gets a response, it deletes the message from the 

!■ queue, otherwise it keeps the message in the queue and resends it the next time Update 

n 

I H Interval timer goes off: As described above the number of retries occurs a specified maxunum 
P 15 number of times, after which the subscriber is considered dead. After some longer interval 

time, the subscriber is automatically tested for aliveness, and the process begins all over. This 
aliveness testing can also be limited to some number of times. This method ensures that an 
alive subscriber does not miss an updateSubscriptionData message. 

As described above, retry attempts should idempotent - that is, multiple retries of a 
20 request should behave as if the request had been sent only once. Idempotency is achieved by 
keeping frack of the change number, or CN, which is a column in the publications and 
subscriptions tables as described above. Note that the underlying service implementation has 
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change number data and keep track of it, entirely independent of SSCP. As used herein, 
change numbers are represented as an as an integer sequence, although it is understood that 
change numbers need not be sequential, but may be whatever the service has, as long as it 
increases (or decreases) monotonically. Note also that the smallest unit of change is a .NET 
blue node, the smallest query-able, cacheable, unit of data in .NET. 

In general, when a fresh subscription is created, the publisher 600 adds a row into the 
pubKcations table 608 (FIG. 6), with CN being set to the lower (upper) bound for the change 
number. . Note that since every .NET blue node already has a change number associated with 
it, this value is guaranteed to be available. The subscriber 610 also keeps track of the value of 
this CN in its subscriptions table 618. Whenever the pubUsher 600 sends an 
updateSubscriptionData request to the subscriber, it includes the value ofCN that it currently 
has for this [.NET blue]node. It records this CN in the publications table 608. 

On receiving the updateSubscriptionData message, the subscriber 610 updates its copy 
of the CN (present in the CN field of subscriptions table 61 8) to the new value. If, due to a 
transient network failure, the publisher 600 fails to receive the response message from the 
subscriber, the publisher resends the request message again at the next update interval. On 
receiving this request, the subscriber inspects the CN, and determines that it has already 
processed this message because the CN in the message is the same as the CN that it has. The 
subscriber treats this as a no-op with respect to making any update, and sends back a response 
whereby the publisher will normally receive it and delete this message from the message 
queue. The net result is that any message received multiple times by the subscriber is 
processed exactly once, i.e., retries are idempotent. 
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The subscriber achieves idempotency because when a pubUsher receives a request to 
add a preexisting entry to its subscription map, it should treat this as a no-op, and not return an 
error. When the publisher receives a request to delete a non-existent entry from its 
subscription map, it should treat this as a no-op and not return an error. As can be readily 
5 appreciated, multiple add or delete from subscription map requests behave as if there was only 
one such request. 

If the publisher fails, the pubUsher will not be able to respond to subscriber requests to 
update the subscription map. This is handled by resending the message until a response is 
U received. As with other retries, long-term or catastrophic failures are handled by having a 
Q 10 limit on the number of retries and waiting for a longer time before starting all over, and then if 
stiU no response after some number of "longer" tune cycles, requiring the attempted recipient 

^ to initiate contact. 

If down, the publisher will also not receive any responses that the subscriber m^ have 

iii sent to its updateSubscriptionData requests. From the point of view of the subscriber, this is 

I'll 

ii3 1 5 logically indistinguishable from the case where the link between subscriber and publisher 
fails, and is handled as described below. 

Subscriber failures are very similar to what happens when the pubUsher fails. The 
subscriber continues to resend the updateSubscriptionMap requests until it receives a response 
from the pubUsher, or the retry limit is reached, whereupon the retry attempts will be held off 
20 for a longer delay time. As in the pubUsher case, the non-reception of responses by the 
subscriber is the same as a link failure, the handUng of which is explained below. 
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In the case where the Unk between the publisher and subscriber fails, the subscriber 
has sent an updateSubscriptionMap message, the publisher has processed this message and 
sent a response, but the subscriber does not receive the response. As described above, this 
causes the subscriber to resend the message. Thus the publisher receives a duplicate 
updateSubscriptionMap message from the subscriber, detected via the change number. Since 
retries are idempotent, the publisher simply sends back a response to the subscriber. A 
subscriber to publisher Unk failure is handled similarly. 

Occasionally, a PUID may be deleted from the publisher and for some reason the 
subscriber does not get notified of this event. When a subscriber sends an 
updateSubscriptionMap request concerning a PUID that no longer exists in the publisher, the 
pubUsher comes back with the <unknownPID> entity in the response. This tells the 

subscriber to update its image of the subscription map. 

Similarly, a SUID may be occasionally deleted at the subscriber and in general, the 

publisher has no way of knowing it. On data change, the pubUsher sends an update request tc 

the deleted SUE), and when this happens, the subscriber sends a 

<deleteFromSubscriptionMap> entity in its response to notify the publisher of the SUID 

deletion. This tells the pubUsher to update its subscription map. 

One catastrophic form of failure is when a publisher loses its subscription map or the 

subscriber loses its subscription data. This can cause various levels of data loss. For 

example, if the pubUsher has experienced a catastrophic failure, such as disk crash, the 

publisher needs to revert to data from a back up medium such as tape. As a result, its 
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subscription map is out of date. For the subscriber, a similar situation makes its subscribed 
data out of date. 

In such an event, the service that experienced the loss sends a message requesting an 
update. The publisher's subscription map can be brought up to date by the information stored 
in subscriptions table in the subscriber, while a subscriber's data can be made up to date by 
the subscription map and the change number stored in the publications table. 

The following section describes pseudocode for implementing key aspects of publisher 
and subscriber protocol handlers. 

When the data changes occur in the publisher, actions impUed by the following 
pseudo-code (as generally represented in FIG. 8) are taken: 



AddToPubUcationQueue(PUID, CN) 

( 

// PUID is the user id whose data was changed. Query the publications 
// table for all SUIDs that are affected, and insert this data into 
// the PUBLICATIONS_QUEUE, if it does not exist already 

## IF NOT EXISTS ( 



## SELECT SUID, PUID, SSID 

## FROM PUBLICATIONS 

## WHERE PUBLICATIONS.PUID = %PUID%) 

## INSERT INTO PUBLICATIONS_QUEUE 

m SELECT SUID, PUID, SSID 

## FROM PUBLICATIONS 

## WHERE PUBLICATIONS.PUID = %PUID% 



// we also need to record the new value of the change number. 
## UPDATE PUBLICATIONS SET CN = %CN% 
## WHERE PUBLICATIONS.PUID = %PUID% 
) 
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When a publisher receives a request message, actions implied by the following 
pseudo-code (also represented in FIG. 9) are taken: 



OnRequestPub(SSID, requestMessage) 

{ 

// what kind of a request message is this? 

switch (requestType) 

{ 

// request is for updating subscription map 
case updateSubscriptionMap: 

// the request can have multiple entities. Loop for each 

for (each entity in request) 

{ 

// See if the PUID of the <publisher> is known 

if(LookUpUser(PUID)) 

{ 

// new subscription 

if (entity = "<addToSubscriptionMap>") 
{ 

// determine role of the subscriber 
role = FindRole(SUID); 

// insert into PUBLICATIONS table. Note that 

// CN is initialized to the current value that the publisher 

// has for it. Note also that 

// tiying to add an existing row is not an error 

## IF NOT EXISTS 

## (SELECT SUE) 

## FROM PUBLICATIONS 

m WHERE 

## SUE) = %SUID% AND 

## PUID = %PUID% AND 

## SSID = %SSID%) 

m INSERT INTO PUBLICATIONS VALUES 

m (%PUID%, %SUID%, %SSID%, %role%, %CN%) 

// append to the response message 
response += "<addedToSubscriptionMap>"; 

} // addToSubscriptionMap 

else if (entity == "<deletedFromSubscriptionMap>") 
{ 

// delete from PUBLICATIONS table. If a non-existent 
// row is asked to be deleted, the delete will simply 
// return without deleting anything 
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## DELETE PUBLICATIONS 
## WHERE 

## SUID = %SUID% AND 
## PUID = %PUID% AND 
## SSID = %SSID% 

// append to the response message 

response += "<deletedFromSubscriptionMap>" 

} // deleteFromSubscriptionMap 

}//LookUpUser(PUID) 
else 

{ 

// append an "unknown PUID entity to response 
response += "<imknownPUID>"; 

} 

}// for (each entity in request) 

break; // updateSubscriptionMap 

case serviceStatus: 

// if serviceStatus is online 
if (entity = "<online>") 
{ 

// reset retry covint to zero 

## UPDATE CONNECTIONS 

## SET RETRY = 0 

## WHERE SID = %SSID% 

} 

else if (entity = offline) 
{ 

// resent retry count to maximum 
## UPDATE CONNECTIONS 
## SET RETRY = %RetryCount% 
## WHERE SID = %SSID% 

} 

// append a standard .NET ack message 
response += "<standard.NETck>"; 

break; // serviceStatus 

} // switch (requestType) 
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} 



// Send response back service 
Send(SSID, response); 



When the update interval timer goes off at the publisher, it takes actions implied by the 
following pseudo-code, as generally represented in FIGS. 10 and 1 1 A-1 IB: 



OnlntervalTimerPubO 

{ 

// get a list of all Subscribes that have live connections 

## SELECT SID AS SSID, RETRY FROM CONNECTIONS 

for (each SSID in result set) 
{ 

if (RETRY < RetryCount) 
{ 

// more retries left, process messages in the publication queue 
// for this SSID 

if (ProcessPublicationQueue(SSID)) 
{ 

// all requests in queue for this SSID have been sent, and 

// responses have been received 

## UPDATE CONNECTIONS 

## SET RETRY = 0 

## WHERE SID = %SSID% 

} 

else 
{ 

// no response from SSID; increment retry counter 
## UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %SSID% 

} 

} // retry < retryCount 

else if (RETRY < Reseflnterval) 

{ 

// retry count exceeded; see if it's time to check for alive-ness 
m UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %SSID% 
} // retry < retrylnterval 



459 



else 
{ 

// check for alive-ness by starting another saies of retries 

## UPDATE CONNECTION 

## SET RETRY = 0 

## WHERE SID = %SSID% 

} 

} // for (each SSID in result set) 

} 



ProcessPublicationQucue(SSID) 

{ 

// select requests in the queue for this SSID; group them by 

// PUID followed by ROLE. The rows in each group will result 

// in one updateSubscriptionData message 

## SELECT * FROM PUBLICATIONS_QUEUE 

m WHERE SSID = %SSID% 

## GROUP BY PUID, ROLE 

for (each group of rows in the result set) 

{ 

// generate an updateSubscriptionData message 
request += GenerateMessage(group); 

) 

// Send request to the subscriber 

if (!Send(SSID, request)) return FALSE; 

// Receive response from service 

if (!Recv(SSID, response)) return FALSE; 

// The response has one entity for each SUE) 
for (each entity in response) 

{ 

success = true; 

if (entity = "<updatedData>") 
{ 

// pubhsher needs to check the change number returned in the 

// response message and verify if it matches; if it does, then 

// everything is cool; if not, then the subscriber has sent a 

// spurious response for a previous request, and so this 

// message is ignored 

## SELECT CN AS STORED__CN 

## FROM PUBLICATIONS 

m WHERE PUID = %pubHsher% AND SUID = %subscriber% 
// CN is the change number contained in the response 
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if(STORED_CN!=CN) 
success = false; 

} 

if (entity = "<deleteFromSubscriptionMap>") 

{ 

// subscriber did not find PUID in its SUBSCSRIPTIONS table 

// publisher should update its subscription map 

m DELETE FROM PUBLICATIONS 

## WHERE PUID=%subscriber% AND SSID=%SSID% 

} 

// since request has received the proper response, it can be deleted from 
// the pubhcation queue 
if (success === true) 

{ 

## DELETE FROM PUBLICATIONS_QUEUE 

## WHERE SSID = %SSID% AND PUID = %publisher% AND SUID = %subscriber% 

} 

} 

} 



When a subscription is added, the actions implied by the following pseudo-code (also 
generally represented in FIG. 12) are taken: 



AddSubscription(suid, puid, psid) 
{ 

// check if the publisher has an entry in the CONNECTIONS table for this 

//PSID 

if (UnknownServiceID( psid )) 
{ 

// no entry exists; send an addSubscription message immediately to 
// the publisher. 

UpdateSingleSubscriptionMap( suid, puid, psid ); 

} 

else 

{ 

// see if row exists in the subscriptions queue 
if (LookUpQueue(suid, puid, psid) 

{ 

// if a row exists in the subscription queue then: 
// if OPERATION is TRUE (=add) then do nothing 
// if it is FALSE (=delete) and GENERATION = 0, then 
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// delete tiie row; otheiwise, change FALSE to TRUE 



## SELECT OPERATION, GENERATION 
## FROM SUBSCRIPTIONS_QUEUE 

m WHERE sum = %suid% AND PUID = %puid% AND PSID = %psid% 

if (OPERATION == FALSE) 
if (GENERATION = 0) 
{ 

## DELETE SUBSCRIPTIONS_QUEUE 

## WHERE SUID = %suid% AND PUID = %puid% AND PSID = %psid% 

} 

else 

{ 

m UPDATE SUBSCRIPTIONS_QUEUE 
## SET OPERATION = TRUE 

## WHERE SUID = %suid% AM) PUID = %puid% AND PSID = %psid% 

} 

} 



// row does not exist; insert into the queue 

## INSERT INTO SUBSCRIPnON_QUEUE 

## VALUES (%suid%, %puid%, %psid%, TRUE, 0) 

} 

} 

} 



When a subscription is removed, the subscriber takes actions implied by the following 
pseudo-code, as generally represented in FIG. 13: 



RemoveSubscriptionCfrom, to, sid) 
{ 

// see if row exists in the subscriptions queue 
if (LookUpQueue(suid, puid, psid) 

{ 

// if a row exists in the subscription queue then: 
// if OPERATION is FALSE (=delete) then do nothing 
// if it is TRUE (=add) and GENERATION = 0, then 
// delete the row; otherwise, change TRUE to FALSE 
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## SELECT OPERATION, GENERATION 
## FROM SUBSCRIPTIONS_QUEUE 

## WHERE SUID = %suid% AND PUID = %puid% AND PSID = %psid% 

if (OPERATION == TRUE) 
if (GENERATION =0) 
{ 

## DELETE SUBSCRIPTIONS_QUEUE 

## WHERE SUID = %suid% AND PUID = %puid% AND PSID = %psid% 

} 

else 
{ 

m UPDATE SUBSCRIPTIONS_QUEUE 

## SET OPERATION = FALSE 

## WHERE SUID = %suid% AND PUID = %puid% AND PSID = %psid% 

} 

} 

else 

{ 

// row does not exist; insert into the queue 

## INSERT INTO SUBSCRPTION_QUEUE 

## VALUES (%suid%, %puid%, %psid%, FALSE, 0) 

) 

1 



When a subscriber receives a request, the actions implied by the following pseudo- 
code are performed as generally represented in FIG. 14; 



OnRequestSub(PSID, request) 
{ 

// what kind of a request message is this? 

switch (requestType) 

{ 

// request is for updating subscription map 
case updateSubscriptionData; 

// request may contain multiple entities 
for (each entity in request) 

{ 

// check to see if the publisher's PUID is in the SUBSCJUPTIONS table 

if(LookUpPUID(publisher)) 

{ 

// is this a duplicate request message? I can find this by looking 
// at change numbers 
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m SELECT CN AS STORED_CN 
m FROM SUBSCRIPTIONS 

## WHERE PUID = %publisher% AND SUID = %subscriber% 
m ANDPID = %pid% 

// cn is the change number preset in the message 

if(cn!=STORED_CN) 

{ 

// This function updates subscaibed data 
UpdateData(entity); 

// update the change number 
## UPDATE SUBSCRIPTIONS 

##SETCN = cn 

## WHERE PUID = %publisher% AND SUID = %subscriber% 
## ANDPID = %pid% 

} 

// append to response 
response += "<updateclData>"; 

} 

else 
{ 

// publisher is unknown; signal publishing service to delete it 
response += "<deleteFromSubscriptionMap>"; 

} 

}//for 

// send response to the publishing service 
break; // updateSubscriptionData 

case serviceStatus: 

// if serviceStatus is online 
if (entity == "<onIine>") 

{ 

// reset retry count to zero 

# UPDATE CONNECTIONS 

# SET RETRY =0 

# WHERE SID = %PSID% 

} 

else if (entity = offline) 
{ 

// resent retry count to maximum 

# UPDATE CONNECTIONS 

# SET RETRY = %RetryCount% 

# WHERE SID = %PSID% 
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1 



// append a standard .NETack message 
response += "<standard.NETAck>"; 

break; // serviceStatus 

} // switch (requestType) 

// Send response back service 
Send(PSID, response); 



When the update interval timer goes off at the subscriber, it takes actions implied by 
the foUov^ing pseudo-code as generally represented in FIGS. 15 and 16A-16B: 



OnlntervalTimerSubO 

{ 

// get a list of all publishers that have live connections 

m SELECT SID AS PSID, RETRY FROM CONNECTIONS 

for (each PSDD in result set) 

{ 

if (RETRY < RetryCount) 
{ 

// more retries left, process msgs in the publication q for this SSID 

if (ProcessSubscriptionQueue(PSE))) 

{ 

// all requests in queue for this PSID have been sent, and 

// responses have been received 

## UPDATE CONNECTIONS 

## SET RETRY = 0 

## WHERE SID = %PSID% 

} 

else 
{ 

// no response from PSID; increment retry counter 
## UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %PSID% 

} 

} // retry < retryCount 

else if (RETRY < Resetlnterval) 

{ 

// retry count exceeded; see if it's time to check for alive-ness 
## UPDATE CONNECTIONS 
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## SET RETRY = RETRY + 1 

## WHERE SID = %PSID% 
} // retry < retrylnterval 
else 
{ 

// check for alive-ness by starting another series of retries 

## UPDATE CONNECTION 

## SET RETRY = 0 

## WHERE SID = %PSID% 

} 

} // for (each SSID in result set) 

1 
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ProcessSubscriptionQueue(PSID) 

{ 

// select requests in the queue for this PSID; group them by 

// PUID followed by OPERATION. The rows in each group will result 

// in one updateSubscriptionData message 

## SELECT * FROM PUBLICATION^QUEUE 

## WHERE PSID = %PSID% 

// generate an updateSubscriptionMap message. Note that all requests 
// for a given psid can be bunched into one single message. Thus, there 
// no need to group by column and loop for each group 
request += GenerateMessageQ; 



// Send request to the publisher 

if (!Send(PSID, request)) return FALSE; 

// Receive response from service 

if (!Recv(PSID, response)) return FALSE; 

// The response has one entity for each row in subscription queue 
for (each entity in response) 

{ 

if (entity == "<addedToSubscriptionMap>") 
{ 

// publisher successfully added its subscription map 
// subscriber now adds to its subscriptions table 
## INSERT INTO SUBSCRff TIONS 
## VALUES (%subscriber%, %publisher%, %psid%) 

} 

if (entity = "<deletedFromSubscriptionMap>") 
{ 

// publisher successfully deleted from its subscription map 
// subscriber now deletes from its subscriptions table 
## DELETE FROM SUBSCRIPTIONS 

## WHERE SUID=%subscriber% AND PUID = %publisher% AND PSID=%PSID% 

} 

// since request has received the proper response, it can be deleted from 

// the subscriptions queue 

## DELETE FROM SUBSCRIPTIONS_QUEUE 

m WHERE PSID = %PSID% AND PUID = %publisher% AND SUID = %subscriber% 

} 

} 
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SSCP ALTERNATIVE 

As described above, alternative ways to implement a service-to-service 
5 conmiunications protocol are feasible. This section describes one such way, and also 

exemplifies an alternative wherein each user can have multiple instances of a .NET (or my*) 
service. For example, a user can have two instances of the myContacts service, one for 
company contacts and one for personal contacts, (although the same segmentation can also be 
U achieved using categories). To distinguish between multiple instances of a user's services, 
'^310 there exists an identifier called INSTANCE, stored in the myServices service. For a given user 

s 

, and a given service, there also exists the notion of a default instance. The combination of an 
Q owner-id (OID) and INSTANCE is enough to uniquely identify a content document. 
U Conceptually, a content document (determined by the OID/INSTANCE pair of the publisher) 
i y gets published to another content document (determined by the OID/INSTANCE pair of the 
:=f 15 subscriber), which are sometimes referred to herein as the publishing document and 
subscribing document, respectively. 

FIG. 20 shows an example of a publisher-subscriber relationship. In FIG. 20, there are 
two myProfile services 2001 and 2002, each managing the profiles of three users. Useri has 
three instances (2004i-20043) of a myProfile service, and user6 has four instances, one of 
20 which resides in the first myProfile service 2001, three of which reside in the second 

myProfile service 2002. There is one myContacts service 2020, which manages the contact 
information of two users; user2 has two instances (2022i and 20222) of the service. In the real 
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world, each of these services will manage the data for millions or even hundreds of millions of 
users. 

As represented in FIG. 20, that myContacts service has subscriptions in the two 
different myProfile services 2001 and 2002; it is similarly likely that a given publisher will 
publish to multiple .NET services. Finally, it should be possible for a single service to act both 
as a subscriber and a publisher (e.g., in the whiteUst example, myContacts is a publisher; in 
the Live Contacts example, it is a subscriber). Thus, as represented in FIG. 20, when the 
profile information for myProfileDocui changes, this information should be pubhshed by 
myProfile service2 2002, to myContacts service 2020, as both myContactsDoci 2021 and 
myContactsDoc2i 2022i have subscribed for the service. SSCP enables the pubUshing of data 
as changes occur, via the push model. Furthermore, in keeping with the present invention, the 
pubhsher should make all attempts to batch the changes to maximally utilize bandwidth. 

In FIG. 20, note that only myContactsDocai subscribes to the profile changes of 
myProfileDocs. Thus, when Users's profile is changed, myProfile should pubUsh the changes 
only to myContactsDoc2u and myContactsDoci should not see these changes. Returning to 
Usere, assume that Useri's role in myProfileDocei is that of an associate; the role of User2 is 
that of a friend. When a myProfile service publishes the data, it should send data visible to an 
associate to myContactsDoci and data visible to a friend to myContactsDoc2i. As should be 
apparent, SSCP sends changes only to subscribed documents (user/instance) within a 
subscribing service, and determines the role of each subscribing user, and filter the data based 
on the role. To this end, the pubhsher maintains information about documents wanting 
subscriptions, which is determined by the OID/INSTANCE pair (myContactsDoci and 
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myContactsDoC2i). For each subscribing document, the publisher also maintains information 
about the dociunent it is subscribing to (for myContactsDoci, this is myProfileDoca and 
myProfileDocs in myProfile Servicei), and about the role played by the owner of the 
subscribing document (for myProfileDocgi in myProfile Service2, this is associate for 
5 myContactsDoci, firiend for myContactsDoc2i). 

Li order for the publisher to keep this information current, the subscriber should notify the 
publisher whenever one of its users wants to unsubscribe or add a new subscription. Note that 
technically, it is a document that subscribes; that is, a user specifies an instance of the service 
1 4 which wants to act as a subscriber, but for purposes of description the user can be thought of 
0 10 as a subscribing. By way of example, consider For example, Useri wants to add User4 into his 
live contact Ust and remove Usere. SSCP should allow for transmission of this information 
fi:om subscriber to pubUsher. SSCP allows the subscriber to send subscription updates to the 
pubKsher. 

f 0 As above, the altemative embodiment described in this section provides robustness, to 

I' 3 15 guarantee that the publisher and subscriber see the messages that they are supposed to see. At 
the most fimdamental level, the publisher or subscriber need to know that their messages have 
reached the destination, whereby a message firom the sender has a corresponding 
acknowledgement (ACK) returned from the receiver. The ACK need not be synchronous with 
respect to the message, and can instead be sent / received asynchronously. 
20 The robust protocol of the present invention also handles the failures of pubUshers or 

subscribers, which is generally accompUshed by resending a request until a response is 
received. However, to prevent a flood of retry messages in case of a catastrophic failure at the 
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destination, a limited number of retries are specified, after which no fiirther attempts are made 
for a longer time. This is accomplished via a reset interval (which is relatively much longer 
than the retry interval) after which the entire retry process begins, 

A more subtle type of failure occurs when, for example, a publish^ sends a request to 
5 the subscriber, informing it of the change in a stored profile, the subscriber processes the 
request, and sends a response to the pubUsher, but the network connection between the 
subscriber and the publisher has a transient failure and the response does not reach the 
publisher. As described above, to retry, the pubUsher resends its request. For the protocol to 
U work correctly, the subscriber recognizes that this is a redundant request that has already been 
t310 processed. In other words, a request should be processed only once even if it is sent multiple 

Is si, 
*. s 

^ J' times; altematively, the request could be processed any number of times, but the next result 

Iff 

f'i 

ji S should be as if it was processed only once. As described above, in SSCP, retries are 
U idempotent. 

jU A typical service manages gigabytes of data, partitioned over millions of users. This 

15 means that in its role as a publisher, the source data will be frequently, if not almost 

constantly, changmg. For efficiency, every change is not published immediately, but instead 
change requests are batched, and send occasionally (e.g., periodically). To this end, the 
protocol handler at the service periodically wakes up after a specified interval and sends the 
batched messages, as described above with respect to FIG. 6. 
20 As generally represented in FIG. 6, SSCP is implemented at a publisher (service) 600 

and subscriber (service) 610 by respective protocol handlers 602, 612, such as daemon 
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processes or the like running with respect to a service. The publisher 600 and subscriber 610 
exchange messages, and use this as a mechanism to communicate changes. 

The requirements of the protocol dictate that SSCP handlers 602, 612 maintain several 
pieces of data, the sum total of which represents the state of a publisher or subscriber. As 
conceptually represented in FIG. 6, this data can be viewed as being segmented over several 
data structures 604-618. Note however that the arrangements, formats and other description 
presented herein are only logically represent the schema; the actual storage format is not 
prescribed, and an implementation may store in any fashion it deems fit as long as it logically 
conforms to this schema. 

A publisher 600 communicates with a subscriber 610 using request and response 
messages* For example, when data changes at the publisher 600, the publisher 600, sends a 
request message to the subscriber 610 informing the subscriber that data has changed, 
normally along with the new data. The subscriber 610 receives the message, makes the 
required updates, and sends back an ACK message acknowledging that the message was 
received and that the changes were made. A subscriber 610 can also send a request message, 
such as when the subscriber 610 wants to subscribe or un-subscribe to a piece of datum. When 
the publisher 600 receives this message, the publisher 600 updates its list of subscriptions (in 
a publications table 608) and sends back a response acknowledging the request. Note that 
SSCP is agnostic to whether a response message for a given request is synchronous or 
asynchronous. 

Thus, there are two primary parts to SSCP, a first firom the publisher to the subscriber, 
which deals with sending changes made to the publisher's data, and a second from subscriber 
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to the publisher, which deals with keeping the list of subscriptions synchronized. 
Furthermore, every service is required to provide notification to all other services tiiat have 
subscriptions with it, or services witii which it has subscriptions, when it is going offline or 
online. 

The table below summarizes request messages, each of which having a corresponding 



response (e.g., ACK) message. 



Message 


Description 


lype 


r roui / 1 0 


updateSubscriptionData 


Used by the publisher to 
publish changes to its data 


Request 


Publisher 
to Subscriber 


updateSubscriptionDataResponse 


Used by the subscriber to 
ack updateSubscriptionData 


Response 


Subscriber 
to Publisher 


updateSubscriptionMap 


Used by the subscriber to 
inform the pubhsher that 
subscriptions have been 
added or deleted 


Request 


Subscriber 
to Pubhsher 


updateSubscriptionMapResponse 


Used by the pubhsher to 
ack UpdateSubscriptionMap^ 


Response 


Publisher 

to Subscriber 


serviceStatus 


Used by both publisher and 
subscriber to inform that 
they are going offline, or 
have come online 


Request 


Both 
directions 


serviceStatusResponse 


Used by both publisher and 
subscriber to ack 
serviceStatus request 


Response 


Both 
directions 



Protocol parameters are supported by both the publisher and the subscriber and control 
the behavior of the protocol 

As noted above, SSCP supports the ability to batch request messages. Whenever there 
is a need to send a request message, such as when there are changes in pubhsher data or 
subscriptions, the service puts the corresponding request message into a publisher message 
queue 606. Periodically, the protocol handler 602 in the pubUshing service 600 wakes up and 
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processes the messages in the queue 606. This period is called as the Updatelnterval, and is a 
configurable parameter. 

To satisfy the robustness requirement, the publisher's protocol handler 602 needs to 
periodically resend requests until the pubUsher service 600 receives an acknowledge message 
(ACK). If the ACK for a message is successfully received, this message is purged firom the 
queue 606. Until then, the message remains in the queue, flagged as having been sent at least 
once, so it will be retried at the next update interval. The nimiber of times the publisher the 
publisher service 600 retries sending a message to the subscriber service 610 is configurable 
by the parameter RetryCount, i.e., after retrying this many times, the publisher service 600 
assumes that the subscriber service 610 is dead. Then, once the maximum number of retries is 
over, the publisher service 600 waits for a relatively longer time. Once this longer time is 
elapsed, the publisher service 600 sets the RetryCount parameter to zero and begins resending 
the queued up requests over again. This longer time (before beginning the retry cycle), is 
configurable by the parameter Resetlnterval. 



Below is the summary of these protocol parameters: 



Parameter 


Use 


Updatelnterval 


The interval after which the protocol handler wakes 
up and processes batched requests. 


RetryCount 


The number of times we retry a connection before 
assuming the remote service is dead. 


Resetlnterval 


The interval after which a service marked as dead is 
retested for alive-ness. 


BoxcarLength 


The maximum number of sub-messages to chain 
together on a given boxcar. 
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Thus, to implement SSCP, the protocol handlers 602, 610 at the pubhsher and 
subscriber, respectively, track of several pieces of information, such as in their respective 
tables 604-618. 

As with .NET in general, SSCP reUes on the entities (services and users) being 
uniquely identifiable by the use of identifiers, e.g., every user in .NET has a unique identifier 
assigned by the Microsoft® Passport service. Each service, be it acting as a publisher or 
subscriber, also has a unique identifier, and in practice, a service JD will be a certificate issued 
by a certification authority. 

SID Generic Service Identifier 

PSID Publishing Service Identifier 

SSID Subscribing Service Identifier 

POID Publishing Owner Identifier (PUID of myPublishingService user) 
PINST Instance ID of POID 

SOID Subscribing Owner Identifier (PUID of mySubscribingService user) 
SINST histance ID of SOID 

To send a request or a response, the service needs to know where the target is located. 
For purposes of the protocol a service is identified either by just the URL or by a series of 
URL/CLUSTER entries. To ensure proper handling of the number of retries for a particular 
service, the handler needs to keep track of how many retries have been done. All this 
information is kept in the CONNECTIONS table, which is used by both publishers and 
subscribers: 
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SID I URL 



CLUSTER 



RETRY 



SID 


The primary key for this table; the service ID of a Subscriber or 
Publisher 


URL 


the URL at which the service is expecting requests 


CLUSTER 


the cluster number of this service 


RETRY 


the current retry number of the service 



There is one entry in this table for every target service. For a publisher, this means 
every service that has subscriptions with it; for a subscriber, this means every publisher that it 
has subscriptions with. When RetryCount < RETRY < Resetlnterval, the target service is 
assumed to be dead. Note that when an unknown service (i.e., one that is not present in the 
CONNECTIONS table) sends a request, an attempt is made to contact it immediately, without 
waiting until the next interval. 



The publisher tracks the users across the services with which it has subscriptions. This 
is done in the PUBLICATIONS table. The PUBLICATIONS table, used by the publisher, 
looks like: 



PKEY 1 poro 


PINST 


SOE) SINST 


SSID SCN 


ROLE 


TOPIC 



wherein: 



PKEY 


The primary key for this table; note that the columns POID, PINST, 
SOID, SINST and SSID form a candidate key 


POID 


Owner-ID of the publisher 


PINST 


Instance ED of the publishing service 


SOID 


Owner-ID of the subscriber 


SINST 


Instance ID of the subscribing service 


SSID 


ID of the subscribing service 


SCN 


Last known change number of an add or delete request received from the 
subscriber. For more information, see section "Error! Reference source 
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not found.". 


ROLE 


Subscribing Owner-ID role in the publishing Owner-ID/Instance's 
roleList for this document 


TOPIC 


If the subscribing document is having multiple subscriptions with a 
publishing document, then a TOPIC is used to distinguish them. 



There is one row in this table for each document/topic/subscribing service 
combination. The PUBLICATIONS table be made visible at the schema level, but should be 
read only. 

Given a publishing service P and a subscribing service S, there will exist a (possibly 
empty) set SM = {(POi, Pli, SOi, Sli, TO, for i = 1 to n} such that: 

1 ) POi is a user managed by P 

2) SOi is a user managed by S 

3) The document (SO^, Slj) subscribes to the document (POi, Pli) with topic Ti. 
The set SM is referred to as the subscription map of P with respect to S, wherein the 

subscription map maybe obtained by the following query: 

SELECT POED, PINST, SOID, SINST, TOPIC 
FROM PUBLICATIONS 
WHERE SSID = S 

The PUBLICATIONS^QUEUE table is used by the publisher to batches the 
requests for the protocol handler to send when the interval is achieved, e.g., the 
Updatelnterval timer goes off. Also, the publisher is required to retry requests for which a 
20 response has not been received. The publisher thus tracks the messages that need to be sent for 
the first time, or those that need to be resent. This is done in the PUBLICATIONS^QUEUE 
table, which looks like this: 
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PQKEY I PKEY 



PCN 



wherein: 



PQKEY 


Primary key for this table 


PKEY 


Identifies the row in PUBLICATIONS table - effectively pointing to a 
document in the publisher service, the changes to which needs to be 
published to a subscribing document 


PCN 


Last known change number of the pubUsher's data which was sent to the 
subscriber 



The PCN field is required to ensure correct updates in situations when multiple 
5 updates happen to the underlying data before a response is received from the subscriber. By 
way of example, suppose that change number five (5) occurs during update interval ten (10); a 
row is inserted into the PUBLICATION_^QUEUE, with PCN=(5). When the interval timer 
goes off for the tenth time, a message is sent to the subscriber, with the changes relating to 
PCN=5» Assume that for whatever reason, a response from the subscriber is not received for 
■3 10 this message, and during update interval eleven (1 1), change number six (6) occurs. This 



5 causes the PCN in the PUBLICATION_QUEUE to be updated from five (5) to six (6). At 



Li: 



this time, the response comes back from the subscriber for the original message containing the 
change number that it had received, which is equal to five (5). The publisher compares this 
change number with the change nxmiber that it has stored in the PUBLICATION_QUEUE 
1 5 table, and finds that the one in the table has a value of 6. So, it knows that more changes need 
to be sent to the subscriber (those corresponding to change number six (6)), and hence it 
retains the row in the queue. Note that if during update interval eleven (1 1), change number 
six (6) did not occur, then the PCN in the PUBLICATION^QUEUE would still be five (5) 
and the publisher's comparison of this change number wifli the change number that it has 
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stored in the PUBLICATION_QUEUE, would be true and the publisher would have deleted 
the row from the queue. 

As described above, the Publication Queue Store does not store messages, but the 
information needed to create the messages. One reason is that the storage required by these 
messages is Ukely to be huge, so rather than storing the actual messages in the table, during an 
update interval, the publisher uses entries in this table to look up the ROLE of the owner of 
the subscribing document (from the PUBLICATIONS table), and generates the request 
message at the time of sending it. Another reason for not storing messages deals with 
multiple updates occurring within a single updateinterval. In this case multiple copies of the 
messages would needlessly get generated and then overwritten. Another reason to not store 
messages in the queue is that messages are collated so that similar data payloads get combined 
into a single outbound request. Generating messages for every queue entry would mean a 
redundant effort, discarded at message send time. 

The subscriber uses a SUBSCRIPTIONS table to keep track of the 
subscriptions that are in effect: 



SKEY 1 SOE) 


SINST 


POID 


PINST 


PSID 


PCN 


TOPIC 



wherein: 



SKEY 


The primary key for this table; note that the columns POID, PINST, 
SOID, SINST and PSID form a candidate key 


son) 


Owner-ID of the subscriber 


SINST 


Instance ID of the subscribing service 


POID 


Owner-ID of the publisher 


PINST 


Instance-ID of the publishing service 


PSID 


ID of the publishing service 


PCN 


Last known change niunber of the publisher's data received from the 
publisher 
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TOPIC 



If the subscribing document is having multiple subscriptions with a 
pubUshing document, then a TOPIC is used to distinguish them. 



Note that the existence of a row in this table implies that the associated pubHshing 
service has one or more associated entries in its PUBLICATIONS table. The PCN field is 
required to ensure that publisher retries are idempotent. 



Recall that the subscriber batches requests and the protocol handler sends the requests 
every time the Updatelnterval timer goes off. Also, the subscriber is required to retry requests 
for which a response has not been received. Thus it needs to keep track of all messages that 

;3 need to be sent for the first time, or need to be resent, which is done in the 

i 10 SUBSCRIPTIONS_QUEUE table: 



SQKEY 1 SOID 


SINST 


TOPIC 


POID 


PINST 


OPERATION 


SCN 



wherein: 


SQKEY 


The primary key for this table 


SOID 


Owner-ID of the subscriber 


SINST 


Instance ID of the subscribing service 


TOPIC 


The TOPIC ID for this subscription 


POID 


Owner-ID of the publisher 


PINST 


Instance-ID of the publishing service 


OPERATION 


Boolean; TRUE is addition and FALSE is deletion of subscription 


SCN 


Change number that keeps track of how many times this subscription has 
been added or deleted. 



Note that the subscription queue does not store messages. Instead, the OPERATION 
1 5 field in the Queue indicates whether this request is to add a subscription or delete a 
subscription. During an update interval, the protocol handler simply looks at the 
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OPERATION field and dynamically generates the appropriate request message. Thus, even 
though the subscription queue does not store the message, it has the information needed to 
formulate the message. Further, note that the subscription queue has multiple columns, while 
the publication-queue has only a key, because the publication queue only needs to identify 
which one of the pre-existing subscriptions needs a data update. Thus, it only needs to store 
the row-id in the PUBLICATIONS table. However, the subscription queue sometimes needs 
to add a subscription, and the information needed for this purpose should be in the 
subscription queue. The SCN field is required to ensure correctness in cases where the user 
adds/deletes the same subscription multiple times - for example, the user adds a subscription, 
and then deletes it or deletes a subscription and then adds it - before the original request was 
sent to, and a response received from, the publisher. In such cases, each change of mind on 
the part of the user is treated as a change, and is assigned a change number. This number is 
passed back and forth between subscriber and publisher in the request and response messages 
and ensure that the multiple adds and deletes are processed properly. 

This updateSubscriptionData message is provided when a user's document gets 
modified. The publishing service checks the contents of the PUBLICATIONS table for 
interested subscribers by issuing the following logical query: 

SELECT * FROM PUBLICATIONS 

WHERE POID=%AFFECTED_POID% AND PINST=%AFFECTED_PINST% AND 

TOPIC=%TOPIC% 

GROUP BY SSID, ROLE 

The publisher uses this information to construct an updateSubscriptionData message to 
each affected subscribing service. For the set of distinct ROLES used within the result set an 
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associated set of filtered data is created in a service dependent manner. Then, the data is 
factored by SSID and each affected subscriber is sent an updateSubscriptionData message 
(actually the messages are queued up and sent the next time the Update Interval timer goes 
off). 

The message format for updateSubscriptionData follows the following schema using 

the XMI conventions: 

<updateSubscriptionData topic- '###">!.. } 
<updateData publisher^''. . . " 

instance-'..." 

changeNumber="###">o. unhomikd 
<subscription subscriber="..." 

instance- \ . ."/>=".. ."o. tir.bour dai 
<subscriptionData>i j <;/subscriptionData> 
</updateData> 

</updateSubscriptionData> 

The data contained in the subscriptionData entity is defined by the participants in the 
service-to-service communication. Docimients which engage in multiple publish/subscribe 
relationships should use the @topic attribute to disambiguate the meaning of the content. The 
@topic attribute is a URI and is specific to the instance of service-to-service communication. 
For instance the myProfile to myContacts communication topic could use a URI like: 
um:microsoft.com:profile-contacts:1.0. No service should attempt to accept an 
updateSubscriptionMap request for any conversation that they have not been expUcitly 
configured to accept. 

The message format for updateSubscriptionDataResponse follows the following 
schema using the XMI conventions: 
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<updateSubscriptionDataResponse topic="###">i j 

<updatedDatapublisher="..." changeNumber="..." 

instance^"...">0. unbounded 

<subscription subscriber^"../' 

instance^". ."o.^unbomuied 

</updatedData> 
<deleteFromSubscriptionMap subscriber=". . 

instance="..." />o..iinboundcd 
</updateSubscriptionDataResponse> 

The function of <updatedData> is to inform the publisher, while 
<deleteFromSubscriptionMap> is used by the subscriber to tell the publisher that this 
SOID/SINST has been deleted. 

When a set of users change their subscription statuses, the set of changes are sent to 
the affected Pubhshers within an updateSubscriptionMap message. When the Publisher 
receives this message it updates the records in the PUBLICATION TABLE. It is important to 
the correctness of the protocol that all updates are handled robustly. In particular it is not an 
error to add an entry more than once. Likewise it is not an error to delete a non-existent entry. 
In both these cases it is important to format the response so that success is indicated for these 
cases. 

The message format for updateSubscriptionMap follows the following schema using 
the XMI conventions: 



<updateSubscriptionMap topic="###">i i 

<addToSubscriptionMap subscriber^"..." 

instance-'..." 

SCn= ### '>o. unbounded 

<subscription publisher="..." 

instance="..."/>=",.,"o. unk^unded 
</addToSubscriptionMap> 
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<deleteFromSubscriptionMap subscriber=",.." 

instance-'../' 

sen— ### '>o L'Tibounded 

<subscription publisher="..." 

instance="...'V>="..."o..unix)uiuied 
</deleteFromSubscriptionMap> 
</updateSubscriptionMap> 



The addToSubscriptionMap section is used to make additions to the subscriptionMap, 
while the deleteFromSubscriptionMap removes entries. 

The message format for updateSubscriptionMapResponse follows the following 
5 schema using the XMI conventions: 



<updateSubscriptionMapResponse topic="###">i i 
<addedToSubscriptionMap subscriber="..." 

instance-'..." 

sen— -^Cunbovjidcd 

<subscription publisher="..." 

instance- '...'7>o .unbounded 
</addedToSubscriptionMap> 
<deletedFromSubscriptionMap subscriber="..." 

instance-'..." 

SCn== if^U ^O.Ain'oounvQd 

<subscription pubhsher="..." 

inStance="..."/>o .unbounded 

</deletedFromSubscriptionMap> 
<unknownPID publishei^"..," instance- ',.,'V>o, unbounded 
</updateSubscriptionMapResponse> 



The <addedToSubscriptionMap> and <deletedFromSubscriptionMap> provide status 
information, while the entity <unknownPID> is used in situations where a pubUshing user is 
10 deleted. 
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Services also need to send out messages when they come on-hne, e.g., to wake up 
other services which have stopped sending them messages. To this end, whenever a service is 
going offline or coming online, the service should send out the following message to its 
partner services stored in its comections table (604 if a publisher, 614 if a subscriber, 
although it is understood that a service may be both a publisher and a subscriber and thus 
access both tables at such a time time). The format of this message using the XMI conventions 
is: 

<serviceStatus>l..l 
<online/>0..1 
<offline/>0..1 

</serviceStatus> 

Only one of the online or offline entities should be sent in any given message. 
There is no defined response format for this message, as the normal .NET My Services 
ACK or fault response supplies the information needed. 

SSCP is designed so that the protocol does not impose any indigenous restrictions on 
what can or cannot be subscribed to. At the one extreme, a service can request a subscription 
to all of publisher's data (at least, all that is visible to it). However, it may also subscribe to 
only a subset of it. The "topic" attribute of updateSubscriptionMap message is used to specify 
this. From the perspective of SSCP, a topic is simply an identifier (mutually agreed upon by 
the subscriber and pubUsher) which specifies what the subscriber wants to subscribe to. For 
instance, if myhibox service only wants to subscribe to an email address in myContacts 
service (which is the case for whiteUsts) then one way of using "topic" attribute would be: 
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1) mylnbox and myContacts agree that the identifier "emailOnl/' indicates that 
only the email address should be subscribed to. 

2) mylnbox sends an updateSubscriptionMap request to myContacts in which it 
sets topic-'emailOnly". 

3) When email data for a contact changes, the pubUsher sends knows to send out 
an updateSubscriptionData message with only the email changes to the subscriber; in 
this message, it sets topic==^"emailC)nly". 

Because Ihe value of the topic attribute is included in updateSubscriptionData 
message, a subscribing document S can have multiple subscriptions with a pubUshing 
document P where each subscription differs by only the topic attribute. 
By way of explanation of the operation of the present invention, the protocol handler wakes 
up when the interval timer goes off, and the handler sends the queued requests, or a request is 
received from another service, and the handler performs the requested action and sends a 
response. By way of example using the Live Contacts operation, consider FIG. 21, in which 
there are three myProfile services whose IDs are PSIDi, PSID2, and PSID3. In FIG. 21 : 

PSIDi contains the profile documents of three users: POIDn, POID12, POID13 

POIDii has three instance documents: 1, 2, and 3. 

POID12 and POID13 have one instance document each. 

PSID2 contains profile documents of two users: POID21 and POID22, each having one 
instance document. 

PSID3 contains profile documents of two users: POID31 and POID32. 
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POIDai has one instance document. 

POID32 has two instance documents: 1 and 2. 

There are two myContacts services whose IDs are SSIDi and SSID2. 

SSIDi manages contact documents of three users: SOIDn, SOID12, and SOHDis, each 

with one instance document. 

SSID2 manages contact documents of two users: S0E)2i and SOID22. 
S0n)2i has two instance documents: 1 and 2. 
SOn)22 has one instance document. 



The initial subscription maps look like below, with each document represented by the 
(owner-id, instance): 
PSIDi: 

(POIDii,!): fiiend(SOIDii,l), associate(SOIDi2,l) 
(P0IDi2,l): other(SOID2i,2) 
(P0IDi3,l): 
PSID2: 

(P0ID2i,l): fiiend(SOIDii,l) 
(POID22,l):fiiend((SOID2i,2),(SOID22,l)), 
associate(SOIDi2,l) 

PSID3: 

(POIDshl): associate(SOIDn,l), other(SOIDi3,l) 
(POID32,2): fiiend(SOID2i,2), associate(SOID22,l) 
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SSlDi: 

(SOIDii,!): (POIDn,l), (POIDzi,!), (POIDai,!) 
(S0IDi2,l): (P0ID„,1), (POID22,l) 
(S0IDi3,l): (POIDahl) 
SSID2: 

(SOID2i,2): (P0IDi2,l), (POID22,l), (POID32,2) 
(SOID22,l): (POID22,l), (POID32,2) 



The two contacts services each include a CONNECTIONS table (for simplicity, 
information such as cluster, URL, and so on, are not shown below). 
For SSIDi the connections table includes: 



SSIDi CONNECTIONS Table 

PSIDi 

PSID2 

PSID3 



while for SSID2 the connections table includes: 



SSID2 CONNECTIONS Table 

PSIDi 

PSID2 

PSID3 



The three profile services each contain a PUBLICATIONS table (for simplicity, 
information such as PKEY or SCN columns are not shown below). 
For PSIDi this looks like: 
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PSIDi PUBLICATIONS Table 



POID 


PINST 


SOID 


SINST 


SSID 


ROLE 


POIDn 


1 


SODDii 


1 


SSIDi 


friend 


POIDii 


1 


SOID12 


1 


SSIDi 


associate 


POID12 


1 


SOID21 


2 


SSID2 


other 



And for PSID2 this looks like: 



PSID2 PU 


BLICATIONS Table 


POID 


PINST 


SOID 


SINST 


SSID 


ROLE 


POID21 


1 


SOIDu 


1 


SSIDi 


friend 


POID22 


1 


SOID12 


1 


SSIDi 


associate 


POID22 


1 


SOID21 


2 


SSID2 


friend 


POID22 


1 


SOID22 


1 


SSID2 


friend 



Finally for PSID3 this looks like: 



PSID3 PUBLICATIONS Table 



POID 


PINST 


SOID 


SINST 


SSID 


ROLE 


POID31 


1 


SOIDii 


1 


SSIDi 


associate 


POID31 


1 


SOID13 


1 


SSIDi 


other 


POID32 


2 


SOID21 


2 


SSID2 


friend 


POID32 


2 


SOID22 


1 


SSID2 


associate 



Updating Subscription Map 

If during an update interval on SSIDi document SOIDn/instancel adds links to the 
documents P0IDi2/instancel and POID32/instance2 and deletes the link from 
POIDu/instancel, while SOIDn/instancel deletes the link from POIDn/instancel the 
contents of the SUBSCRIPTIONS^^QUEUE for SSIDi is: 
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SSIDi SUBSCRJPTIO] 


MS QUEUE 


SOID 


SINST 


POID 


PINST 


PSID 


OPERATION 


SCN 


SOIDii 


1 


P0E>i2 


1 


PSIDi 


TRUE 


0 


SOIDii 


1 


POID32 


2 


PSID3 


TRUE 


0 


SOIDii 


1 


POIDii 


1 


PSDDi 


FALSE 


0 


SOID12 


1 


POIDii 


1 


PSIDi 


FALSE 


0 



When processed this will generate two different updateSubscriptionMap requests that 
are sent to the two affected myProfile services. PSIDi is sent: 



<updateSubscriptionMap topic="####"> 

<:addToSubscriptionMap subscribei="SOIDii" instance^"!" 

scn="0"> 

<subscription publisher=''P0IDi2'' instance="rV> 
</addToSubscriptionMap> 
<deleteFromSubscriptionMap subscriber="SOIDi 1" 

instance="r' scn="0"> 
<subscription publisher="POIDii" instance="rV> 
</deleteFromSubscriptionMap> 
<deleteFromSubscriptionMap subscriber="S0IDi2" 

instance="l" scn="l"> 
<subscription publisher="POIDii" mstance="l"/> 
</deleteFromSUbscriptionMap> 
</updateSubscriptionMap> 

i ^ 

5 AndPSIDsissent: 



<updateSubscriptionMap topic="####"> 

<addToSubscriptionMap subscriber="SOIDii" 

instance="l" scn="0"> 
<subscription publisher-'TOIDsa" instance="2'V> 
</addToSubscriptionMap> 
</updateSubscriptionMap> 



After receiving these messages each myProfile service updates the contents of their 
PUBLICATIONS table as follows (with the TOPIC and SCN columns not shown). 
For PSIDi the resulting table looks like: 
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PSEDiPU] 


BLICATIONS Table 


POID 


PINST 


son) 


SINST 


SSID 


ROLE 


POID12 


1 


S01D21 


2 


SSID2 


Other 


POID12 


1 


SOE)ii 


1 


SSIDi 


associate 



And for PSID3 the resulting table looks like: 



PSID3 PUBLICATIONS Table 



POID 


PINST 


SOID 


SINST 


SSID 


ROLE 


POID31 


1 


SOIDii 


1 


SSIDi 


associate 


POID31 


1 


SOID13 


1 


SSIDi 


Other 


POID32 


2 


SOIDii 


1 


SSIDi 


Other 


POID32 


2 


SOID21 


2 


SSID2 


Friend 


POID32 


2 


SOID22 


1 


SSID2 


associate 



Assuming from the original configuration that document POBDn/instancel changes 
the contents on his or her profile. So PSBDi constructs the following updateSubscriptionData 
message to SSIDi: 



<updateSubscriptionData topic="####"> 

<updateData publisher="POIDn" instance="r' 
changeNumber="###"> 
<subscription subscriber=''SOIDn'' instance="rV> 
<subscriptionData>fiiend-info</subscriptionData> 
</updateData> 

<updateDatapublisher="POIDu" instance="l" 
changeNumber="###"> 
<subscription subscriber^^SOIDu" instance- '!"/> 
<subscriptionData>associate-info<;/subscriptionData> 
</updateData> 
I </updateSubscriptionData> 

Note that the message is split between two updateData blocks because of different 
roles being assigned. If POID22/instacel was to change his profile information this would 
10 result in PSID2 sending out two updateSubscriptionData messages to SSIDi and SSID2. 
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<!" to SSIDi -> 



<updateSubscriptionData topic="####"> 

<updateData publisher="POID22" instance="l" 
changeNumber="###"> 
<subscription subscriber="S0IDi2" instance="rV> 
<subscriptionData>associate-info</subscriptionData> 
</updateData> 
</updateSubscriptionData> 

<updateSubscriptionData topic=' W##"> 



<!--toSSID2 -> 



<updateSubscriptionData topic="####"> 

<updateData publisher="POID22" instance-"!" 

changeNumber="###"> 
<subscription subscriber="S0ID2i" instance="2"/> 
<subscription subscriber="SOID22" instance="rV> 
<subscriptionData>fiiend-info</subscriptionData> 
</updateData> 

</updateSubscriptioDData> 

Note in this case the message to SSID2 only contains one copy of the data optimizing 
for identical roles. 

As described herein, SSCP is a robust protocol which is able to handle many different 
kinds of failure scenarios, including: 

1) Publisher fails 

2) Subscriber fails 

3) The link between publisher and subscriber goes down before the 
subscriber can respond (after it has received a request) 

4) The link between publisher and subscriber goes down before the 
pubUsher can respond (after it has received a request) 
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5) Publisher loses the subscription map 

6) Subscriber loses published data 

These failure scenarios are handled by the protocol via message retries and 
idempotency. 

In the following explanation, it is assumed that the pubUsher sends the request 
message, however this applies equally well when the subscriber sends the request message. 
When the publisher sends a request message, SSCP follows the following algorithm: 

1) Pubhsher sends a message from the PlJBLICATIONS_QUEUE. 

2) It waits for a response to this message 

a) If it gets a response, it deletes the message from the queue 

b) Otherwise, it keeps the message in the queue and resends it the next 
time the Update Interval timer goes off. 

3) As explained herein, the number of times a message is resent is bounded by a 
maximum after which the subscriber is considered dead. It is tested for alive-ness after 
a "long time" and the process begins all over. 

4) This method ensures that the subscriber does not miss an 
updateSubscriptionData message. 

As described above, retry attempts should idempotent, i.e., multiple retries of a request 
should behave as if the request had been sent only once. Idempotency is achieved by keeping 
track of the change number, or PCN (which is a column in the PUBLICATIONS and 
SUBSCRIPTIONS tables). Note that the underlying service implementation has change 
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number data, and keeps track of it, independent of SSCP. As used herein such changed 
numbers are logically reflected as an integer sequence, however in general, the PCNs need not 
be sequential, but instead may be whatever the service has, as long as it increases or decreases 
monotonically. Note also that the smallest unit of change is a .NET blue node, wherein 
5 currently a blue node is the smallest query-able, cacheable, unit of data in .NET. 
Change numbers generally work as follows: 
When a fresh subscription is created, the publisher adds a row into the 
PUBLICATIONS table, with PCN being set to 0 to indicate that no data has yet been 
u exchanged. The subscriber also keeps track of the value of this PCN in its SUBSCRIPTIONS 
□ 10 table. Whenever the pubUsher sends an updateSubscriptionData request to the subscriber, it 

itsSr. 

includes the value of PCN that it currently has for this (e.g., blue) node. It records this PCN in 
f ^ the PUBLICATIONS table. On receiving the updateSubscriptionData message, the subscriber 

U updates its copy of the PCN (present m the PCN field of SUBSCRIPTIONS table) to the new 

□ 

! y value. If, due to a transient network failure, the publisher fails to receive the response 
1 5 message from the subscriber, it resends the request message again at the next update interval. 
On receiving this request, the subscriber inspects the PCN; it knows that it has already 
processed this message because the pubhsher's change number in the message is the same as 
the PCN that it has, and thus treats this as a no-op and sends back a response. The publisher 
deletes this message from the message queue, and the net result is, any message received 
20 multiple times by the subscriber is processed exactly once - i.e., retries are idempotent. 

The subscriber achieves idempotency is by the following rules: when a publisher 
receives a request to add a preexisting entry to its subscription map, it should treat this as a 
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no-op and not return an error. When the pubhsher receives a request to delete a non-existent 
entry from its subscription map, it should treat this as a no-op and not return an error. As can 
be appreciated, multiple add or delete from subscription map requests behave as if there of 
only one such request. 

The SCN field is required to ensure correctness in cases where the user adds/deletes 
the same subscription multiple times - for example, the user adds a subscription, and then 
deletes it or deletes a subscription and then adds it - before the original request was sent to, 
and a response received from, the pubhsher. In such cases, each change of mind on the part of 
such a user is treated as a change, and is assigned a change number. Change numbers are 
monotonically increasing. Here is how change numbers (SCN) are treated with in the 
publisher and subscriber algorithms: 

A) Whenever a user adds or deletes a subscription, the subscriber looks at its subscription 
queue to see if there exists a pending request in queue from this user/instance pair to the 
corresponding pubHshing document. 

I) If there exists such a pending request, then the subscriber replaces the request with the 
new one. 

n) If a pending request does not exist, then the subscriber inserts the new request. 
IE) In either case, the SCN is updated to a new increased value. 

B) The net result of the above is: at any given point, the subscription queue contains only the 
last request made by the user; but the change number has increased every time the user 
changes his mind. 

C) The updateSubscriptionMap request includes the current value of the change number from 
the queue for each add or delete entity present in the request. 

D) When the publisher receives an updateSubscriptionMap request, it does the following for 
every add/delete entity in the request: 

I) If the entity is add, then: 

i) If this subscription is already present in the publications table and then: 

(1) if the SCN in the message is greater than the SCN that it has, then it updates to 
the higher value of SCN 
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(2) Otherwise it is ignored, 
ii) Otherwise it inserts this subscription into the publications table, records the SCN. 
n) If the entity is delete, and if this subscription is present in the publications table then: 

i) It is deleted if the SCN in the message is greater than the SCN that the publisher 
has, it deletes the subscription from its publications table. 

ii) Otherwise it is ignored. 

In any case, it sends the SCN that it received as part of the response message. 

E) When a subscriber receives an updateSubscriptionMapResponse from the publisher, it 
does the following for each entity in the response: 

I) If there is no entry in the subscription queue corresponding to this entity, then it is 
ignored 

n) Otherwise: 

i) If the SCN in the entity is less than the SCN in the queue, then it is ignored. 

ii) Otherwise, the corresponding entry in the queue is removed. 

To see why this algorithm works, consider the following cases: 

1) In an ordinary case (happens large majority of the time), when a User does an add (or a 
delete) 

a) The add (delete) is stored in the queue with SCN = 2 

b) (Assume) This subscription does not exist (exists) at the pubUsher. 

c) At the next update interval, the subscriber sends an updateSubscriptionMap message 
with an add (delete) entity for which SCN = 2 

d) The publisher receives this request; it adds it to (deletes it from) the publication table 
with SCN==2, and sends back a response with SCN=2 

e) The subscriber compares the SCN in the response finds that it is the same as what is in 
the queue, and purges the queue. 

f) Net effect: the subscription is added (deleted). 

In extraordinary cases: 

2) User does an Add followed by a delete within the same update interval: 

a) The add is stored in the queue with SCN = 2 

b) The delete request overwrites the add request, and the SCN is updated to 3. 
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c) (Assume) This subscription does not exist at the pubhsher. 

d) At the next update interval, the subscriber sends an updateSubscriptionMap message 
with a delete entity for which SCN = 3 

e) The publisher receives this request; since the subscription does not exist, it does 
nothing, and sends back a response with SCN=3 

f) The subscriber compares the SCN in the response finds that it is the same as what is in 
the queue, and purges the queue. 

3) Same as above, but add and delete happen within different update intervals 

a) Add is stored in the queue with SCN = 2 

b) When update interval timer goes off, an updateSubscriptionMap is sent with an add 
entity for which SCN = 2. 

c) Three cases are generally possible: 

i) The message reaches the pubhsher and it sends a response which reaches the 
subscriber. Call this SUCCESS case. 

ii) The message reaches the publisher and it sends back a response which does not 
reach the subscriber. Call this PARTIAL case 

iii) The message does not reach the pubhsher. Call this the FAILURE case. 

d) hi the SUCCESS case: 

i) The process of addition takes place at the publisher as explained in case (1). An 
SCN of 2 is stored in the pubhcation table. 

ii) The user now asks that the subscription be deleted, which causes a delete to be 
stored in the queue with SCN = 3. 

iii) During the next update interval, an updateSubscriptionMap message is sent with a 
delete entity for which SCN == 3. 

iv) The process of deletion takes place as explained in case (1) 

e) hi the PARTIAL case: 

i) Since the publisher has received the add message, the process of addition takes 
place at the publisher as explained in case (1). An SCN of 2 is stored in the 
publication table. 

ii) The subscriber has not received a response for the add, so the add remains in the 
queue. 

iii) The user now asks that the subscription be deleted, which causes a delete to be 
stored in the queue with SCN == 3. The add has been over-written. 

iv) During the next update interval, an updateSubscriptionMap message is sent with a 
delete entity for which SCN = 3. 
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v) A delete is performed as explained in case (1) 

vi) If, for some reason, the original response that the publisher sent for the add 
message now reaches the subscriber, the subscriber simply ignores it since there is 
no entity in the subscription queue that corresponds to this response. 

f) With respect to the subscriber, the FAILURE case is logically equivalent to the 
PARTIAL case and is handled identically; with respect to the publisher, the only 
difference between PARTIAL and FAILURE is: in the FAILURE case, the delete 
request is a no-op since the publisher never received the add request. 

The cases above have considered an add followed by a delete. Clearly, a delete 
followed by an add also works similarly. Furthermore, a series of adds/deletes by the user (in 
any order and in any interval and in any combination of the success/partial/failure cases) will 
also work and the right things will happen. However, there is are cases that are particularly 
problematic: 

4) A trick case: requests arrive at the pubUsher out of sequence. 

a) The user does an add. This request is kept in the queue with an SCN = 2. 

b) At the next update interval, an updateSubscriptionMap request is sent to the pubUsher 
with an add entity and SCN = 2. 

c) Next the user does a delete of the same subscription. This request is kept in the queue 
withanSCN = 3. 

d) At the next update interval, an updateSubscriptionMap request is sent to the pubUsher 
with an add entity and SCN = 3. 

e) For some strange reason, the delete request arrives at the pubUsher before the add 
request. 

f) The pubUsher processes the delete request by removing this subscription (if it exists), 
and sends a response with SCN = 3. 

g) The subscriber deletes the corresponding entity from the queue. 

h) Now the pubUsher receives the add request with SCN = 2. According to the algorithm, 
it adds the subscription to its publication queue. And it sends back a response with 
SCN = 2. 

i) The subscriber ignores this response since there is no entity in the subscription queue 
corresponding to this response. 
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The net of this is, there now exists a subscription in the publisher which shouldn't 
be there. The net resuh of the trick case is that it is possible for a rogue subscription to 
exist at the publisher; the subscriber has no record of this subscription in its subscription 
table. As a result, it is possible for the subscriber to receive an updateSubscriptionData 
message for a subscription that does not exist. When this happens, the subscriber does the 
following: 

A) It checks its subscription queue to see if the queue has a delete or an add message for this 
subscription. If there is one, then it does nothing. 

B) If there isn't a delete message in the queue akeady, it inserts a message in the queue with 
an incremented SCN 

C) At the next update interval, an updateSubscriptionMap message is sent to the publisher. 

D) When the publisher receives this message: 

T) it checks its pubUcation queue to see if there are any pending messages to be sent to 
this subscription in its pubUcation queue. If there is, these pending messages are 
removed. 

n) It deletes the subscription from its publications table and sends a response back. 

The cases above have considered an add followed by a delete, but note that a delete 
followed by an add also works similarly. Furthermore, a series of adds/deletes by the user (in 
any order and in any interval and in any combination of the success/partial/failure cases) will 
also work and the right things will happen. However, another case is particularly problematic: 
5) A trick case: requests arrive at the pubUsher out of sequence. 

a) The user does an add. This request is kept in the queue with an SCN = 2. 

b) At the next update interval, an updateSubscriptionMap request is sent to the pubUsher 
with an add entity and SCN = 2. 
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c) Next the user does a delete of the same subscription. This request is kept in the queue 
withanSCN = 3. 

d) At the next update interval, an updateSubscriptionMap request is sent to the publisher 
with an add entity and SCN = 3. 

5 e) For some strange reason, the delete request arrives at the pubUsher before the add 

request. 

f) The publisher processes the delete request by removing this subscription (if it exists), 

and sends a response with SCN = 3. 
i, ^ g) The subscriber deletes the corresponding entity from the queue. 
iiilO h) Now the publisher receives the add request with SCN = 2. According to the algorithm, 

i : 

itXSS 

'i[ it adds the subscription to its publication queue. And it sends back a response with SCN = 2. 
•5j i) The subscriber ignores this response since there is no entity in the subscription queue 

!i 

corresponding to this response. 
! li The net of this is, there now exists a subscription in tiie publisher v^rhich shouldn't be 

^15 there. The net result of the trick case is that it is possible for a rogue subscription to exist at 

jJ sis 

the publisher; the subscriber has no record of this subscription in its subscription table. As a 
result, it is possible for the subscriber to receive an updateSubscriptionData message for a 
subscription tiiat does not exist. When this happens, the subscriber does tiie following: 

E) It checks its subscription queue to see if the queue has a delete or an add message for this 
20 subscription. If there is one, then it does nothing. 

F) If there isn't a delete message in tiie queue akeady, it inserts a message in tiie queue witii 
an incremented SCN 
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G) At the next update interval, an updateSubscriptionMap message is sent to the pubUsher. 

H) When the publisher receives this message: 

T) it checks its publication queue to see if there are any pending messages to be sent to 
this subscription in its publication queue. If there is, these pending messages are removed, 
n) It deletes the subscription jfrom its publications table and sends a response back. 

Thus, this unusual case simply means that there will exist one or more rogue 
subscriptions at the pubHsher until such time that the data subscribed by these rogue 
subscriptions change. At this point, the protocol logic takes over and deletes the rogue 
subscription. Note that the vast majority of the time, the simple case (1) is what takes place, 
and the otiier cases occur only very rarely. 

When the publisher fails, the pubUsher will not be able to respond to subscriber 
requests to update the subscription map, which is handled by resending the message until a 
response is received. Long-term or catastrophic failures are handled by having a limit on the 
number of retries and waiting for a "long time" before starting all over. The pubUsher will 
also not receive any responses that the subscriber may have sent to its updateSubscriptionData 
requests. From the point of view of the subscriber, this is logically indistinguishable from the 
case where the link between subscriber and pubUsher fails. 

When the subscriber fails, it is very similar to what happens when the pubUsher fails. 
The subscriber continues to resend the updateSubscriptionMap requests until it receives a 
response from the pubUsher. As in the pubUsher case, the non-reception of responses by the 
subscriber is the same as a link failure. 
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A failure case can occur when the subscriber has sent an updateSubscriptionMap 
message, and the publisher has processed this message and sent a response, but the link 
between the publisher and subscriber fails. As a result, the subscriber does the not receive the 
response. As described in the section "Message retries", this causes the subscriber to resend 
the message. Thus the publisher receives a duphcate updateSubscriptionMap message from 
the subscriber. Since retries are idempotent, the pubUsher simply sends back a response to the 
subscriber. When the subscriber to publisher link fails, it is handled similarly. 

Occasionally, POID/INSTANCE is deleted from the pubUsher, and the subscriber 
usually does not get notified of this event. Thus, when the subscriber sends an 
updateSubscriptionMap request conceming a POID/INSTANCE that no longer exists in the 
publisher, the publisher comes back with an <unknownPID> entity in the response. This tells 
the subscriber to update its image of the subscription map. 

Occasionally, a SOID/INSTANCE is deleted at the subscriber; in general, the 
publisher has no way of knowing it. On data change, the publisher sends an update request to 
the deleted SOID/INSTANCE; when this happens, the subscriber sends a 
<deleteFromSubscriptionMap> entity in its response to notify the publisher of the 
SOID/INSTANCE deletion. This tells the pubUsher to update its subscription map. 

One catastrophic form of failure is when a pubUsher loses its subscription map or the 
subscriber loses its subscription data. This can cause various levels of data loss. For 
example, if the pubUsher has experienced a catastrophic failure, such as disk crash, the 
pubUsher needs to revert to data from a back up medium such as tape. As a result, its 
subscription map is out of date. For the subscriber, a similar situation makes its subscribed 
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data out of date. In such an event, the service that experienced the loss sends a message 
requesting an update. The publisher's subscription map can be brought up to date by the 
information stored in subscriptions table in the subscriber, while a subscriber's data can be 
made up to date by the subscription map and tiie change number stored in the publications 
table. 

In general, the service that experienced the loss has enough knowledge to send a 
message requests an update. The publisher's subscription map can be brought up to date by 
the information stored in SUBSCRIPTIONS table m the subscriber. A subscriber's data can 
be made up to date by the subscription map and the publisher's change number stored in tiie 
PUBLICATIONS table. 

The following describes the pseudo code for hnplementing key aspects of publisher 
and subscriber protocol handlers. Note that to avoid repetition and for brevity, separate flow 
diagrams are not provided to secondarily represent this pseudocode. 

When the service or cluster starts up or is going throu^ an orderly shutdown it sends 

out status messages to all connected services. 

ServiceStartupO 
{ 

serviceStatusRequest request; 
request.entity = "<startup/>"; 

## SELECT SID FROM CONNECTIONS 

for (each SID in result set) 

{ 

Send(SID,request); 

} 

} 
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ServiceShutdownQ 
{ 

serviceStatusRequest request; 
request-entity = "<shutdow]i/>"; 

## SELECT SID FROM CONNECTIONS 

for (each SID in result set) 

{ 

Send(SID,request); 

} 

} 



When the update interval timer goes off at the subscriber or publisher, it takes actions 
implied by the followmg pseudo-code. Note that the ProcessQueue routine is implemented 
differently by subscribers and publishers: 



OnlntervalTimerO 
{ 

// get a list of all live connections 

## SELECT SID, RETRY FROM CONNECTIONS 

for (each SID in result set) 

{ 



if (RETRY < RetryCount) 
{ 

// more retries left, process messages in the queue 
// for this SID. The topics collection is stored in the 
// standard XML system configuration document 
for (TOPIC in TOPICS) 

ProcessQueue(SID, TOPIC); 

} 

else if (RETRY < Resetltiterval) 
{ 

// retry count exceeded; see if it's time to check for alive-ness 
## UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %SID% 

} 

else 

J 
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// check for alive-ness by starting another series of retries 








m T IPD ATE CONNECTION 








## SET RETRY = 0 


} 


} 


} 


## WHERE SID = %SID% 



S Service Status Messages 

When a publisher or a subscriber receives a ServiceStatusMessage the following code is 

executed: 



OnServiceStatus(SID, requestMessage) 

{ 

serviceStatusResponse response; 

// if serviceStatus is online 

if (requestMessage.entity == "<online/>") 

{ 

// reset retry count to zero 

## UPDATE CONNECTIONS 

## SET RETRY = 0 

## WHERE SID = %SID% 

response.entity = "<online/>"; 
Send(SID, response); 

} 

else if (requestMessage.entity = "<offline/>") 
{ 

// resent retry count to maximum 
## UPDATE CONNECTIONS 
## SET RETRY = %RetryCount% 
## WHERE SID = %SID% 

} 

J 
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When the data changes occur in the publisher, actions implied by the following 
pseudo-code are taken: 



OnDataChanged(PUID, PINST, PCN, TOPIC) 

^ // PUID/PINST is the user id whose data was changed. Query the pubUcations 
// table for all SUIDs that are affected, and insert this data into 
// the PUBLIC ATIONS_QUEUE, if it does not exist aheady. 

## SELECT VKEY FROM PUBLICATIONS 
## WHERE POID = %POID% 

## AND PINST = %PINST% AND TOPIC = %TOPIC% 

for (each PKEY in the result) 
{ 

NOT EXISTS ( 
## SELECT * FROM PUBLICATIONS_QUEUE 
## WHERE PUBLICATIONS.PKEY= %PKEY%) 
## INSERT INTO PUBLICATIONS_QUEUE 

## (PKEY, PCN) VALUES (%PKEY%, %PCN%) 

##ELSE 

## UPDATE PUBLICATIONS_QUEUE SET PCN=%PCN% 

## WHERE PUBLICATIONS_QUEUE.PKEY = %PKEY% 



When the update interval timer goes off at the publisher, it takes actions impUed by the 
following pseudo-code: 



ProcessQueue(SSID, TOPIC) 
{ 

UpdateSubscriptionDataRequest request; 

// select requests in the queue for this SSID; group them by 

// PUID followed by ROLE. The rows in each group will result 

// in one updateSubscriptionData message 

## SELECT POID, PINST, SOID, SINST, ROLE, PCN 

## FROM PUBLICATIONS_QUEUE PQ JOIN PUBLICATIONS P 

## ON PQ.PKEY = P.PKEY 

## WHERE SSID = %SSID AND PQ.TOPIC = %TOPIC% 
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## GROUP BY POID, PINST, ROLE 
for (each group of rows in the result set) 
{ 

// gather up data for the per-topic part of this message 
data = GenerateTopicData(POID, PINST, ROLE, TOPIC) 

// generate an updateSubscriptionData message 
request += GenerateMessage(group, data); 

} 

// Send request to the subscriber 
Send(SSID, request); 

// Assume the worst and age the connection 
## UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %SSID% 

J ^ ■ 

When a publisher receives an UpdateSubscriptionMap message, actions impKed by the 
following pseudo-code are taken: 



OnUpdateSubscriptionMap(SSID,requestMessage) 
{ 

UpdateSubscriptionMapResponse response; 

// Mark this connection as live 
## UPDATE CONNECTIONS 
## SET RETRY = 0 
## WHERE SID = %SSID% 

// the request can have multiple entities. Loop for each 
for (each entity in requestMessage) 

^ // See if the POID, PINST of the <publisher> is known 
if (LookUpUser(POID, PINST)) 

{ 

// new subscription 

if (entity = "<addToSubscriptionMap>") 

addToSubscriptionMap(SSID, entity, response, TOPIC); 
1 . 
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else if (entity == "<deletedFromSubscriptionMap>") 

^ deleteFromSubscriptionMap(SSID, entity, response, TOPIC); 
} // deleteFromSubscriptionMap 

} 

else 

{ 

// append an "unknown PUID entity to response 
response+="<unknownPUID publisher='"+POID+"' 
instance='"+PINST+'"/>"; 
} 

} 

Send(SSID, response); 

} 



// Helper routine to handle add subMessage 
addToSubscriptionMap(SSID, subMessage, response, TOPIC) 

response -H= "<addedToSubscriptionMap "; 

response += "subscriber='"+S01D+"' instance='"+SINST+"7>"; 

// the request can have multiple entities. Loop for each 
// determine role of the subscriber 
for (sub in subMessage) 

^ ROLE = FindRole(POID, PINST, SOID); 



## IF NOT EXISTS 

## (SELECT PKEY 
## FROM PUBLICATIONS 
## WHERE 



## son) = %SOID% AND SINST = %SINST% AND 

## POID = %POID% AND PINST = %PINST% AND 

## SSID = %SSID% AND TOPIC = %TOPIC%) 

## BEGIN 

## INSERT INTO PUBLICATIONS VALUES 

## (%POID%, %PINST%, %SOID%, %SINST%, %SSID%, 

%SCN%, %ROLE%, %TOPIC%) 
// set an initial message to update this subscriber 
## INSERT INTO PUBLICATIONS_QUEUE VALUES 
m (@@IDENTITY, %PCN%) 
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##END 
##ELSE 
## BEGIN 

## UPDATE PUBLICATIONS SET SCN = sub.SCN 

## WHERE 

## SOID = %SOID% AND SINST = %SINST% AND 
## POID = %POID%ANDPINST = %PINST%AM) 
## SSID = %SSID% AND TOPIC = %TOPIC% AND 
## SCN < sub.SCN 
##END 

response += "<subscription publisher='"+POID+"' instance="'+PINST+"'/>"; 

} 

// append to the response message 
response += "</addedToSubscriptionMap>"; 

J ^ 



// Helper routine to handle delete subMessage 
deleteFromSubscriptionMap(SSID, subMessage, response, TOPIC) 

response += "<deletedFromSubscriptionMap "; 

response += "subscriber='"+SOID+"' instance='"+SINST+"'/>"; 

// the request can have multiple entities. Loop for each 

for (sub in subMessage) 

{ 

// delete from PUBLICATIONS table. If a non-existent 
// row is asked to be deleted, the delete will simply 
// return without deleting anything 

## SELECT SCN AS STORED_SCN FROM PUBLICATIONS 

## WHERE 

## SOID = %SOID% AND SINST = %SINST% AND 
## POID = %POID% AND PINST = %PINST% AND 
## SSID = %SSID% AND TOPIC = %TOPIC%) 
## 

## IF (result is not empty or STORED_SCN < %SCN%) 
## DELETE PUBLICATIONS 

## WHERE 

## SOID = %SOID% AND SINST = %SINST% AND 

## POID = %POID% AND PINST = %PINST% AND 
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## SSID = %SSID% AND TOPIC = %TOPIC%) 

// NOTE: Are assuming cascade delete on PKEY is set up 

response += "<subscriptionpublisher='"+POID+"' instance='"+PINST+'"/>"; 

} 

// append to the response message 

response += "</deletedFromSubscriptionMap>"; 

i_ 

When a publisher receives an UpdateSubscriptionDataResponse message, actions 
implied by the following pseudo-code are taken: 

OnUpdateSubscriptionDataResponse(SSID, response) 
{ 

// Mark this connection as live 
## UPDATE CONNECTIONS 
## SET RETRY = 0 
## WHERE SID = %SSID% 

// The response has one entity for each SOID 

for (each entity in response) 

{ 

if (entity = "<updatedData>") 
{ 

updatedData(SSID, entity, TOPIC); 
if (entity = "<deleteFromSubscriptionMap>") 

^ // subscriber did not find SOID/SINST in its SUBSCRIPTIONS table 
// publisher should update its subscription map 
## DELETE FROM PUBLICATIONS 
## WHERE SOID=%SOID% AND SINST=%SINST% 

} 

} 

Li ^ 



// Helper routine to handle the update subMessage 

updatedData(SSID, subMessage, TOPIC) 

i . 
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for (sub in subMessage) 

// publisher needs to check the change number returned in the 
// response message and verify if it is vaUd; if it is, then 
// everything is cool; if not, then the subscriber has sent a 
// spurious response for a previous request, and so this 
// message is ignored 

## DELETE FROM PUBLICATIONS_QUEUE 

## WHERE PKEY = %PKEY% AND PCN <= %subMessage.PCN% 

} 

] 



When a subscription is added, the actions implied by the following pseudo-code are 

taken: 



// check if the pubUsher has an entry in the CONNECTIONS table for this 
//PSID 

if(UnknownServiceID(PSID)) 

// no entry exists; send an addSubscription message immediately to 
// the publisher. 

UpdateSingleSubscriptionMap(SOID, SINST, POID, PINST, PSID, TOPIC, SCN); 

} 

else 

{ 

// see if row exists in the subscriptions queue 
## IF EXISTS ( 

## SELECT SKEY FROM SUBSCRIPTIONS_QUEUE 
## WHERE SOID - %SOID% AND SINST = %SINST% 
## AND POID -%POID% AND PINST = %PINST% 

## AND PSID = %PSID% AND TOPIC = %TOPIC%) 

## BEGIN 

## UPDATE SUBSCRIPTIONS_QUEUE 

## SET OPERATION = TRUE, SCN = %SCN% 

## WHERE SOID = %SOID% AND SINST = %SINST% 

## AND POID = %POID% AND PINST = %PINST% 

## AND PSID = %PSID% AND TOPIC = %TOPIC% 

##ELSE 

## BEGIN 

// row does not exist; insert into the queue 
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## INSERT INTO SUBSCRIPTION_QUEUE 

## VALUES (%SOID%, %SINST%, %TOPIC%, %POE>%, %PINST%, 

TRUE, %SCN%) 

##END 

} 



AddSubscription(SOID, SINST, POID, PINST, PSID, TOPIC, SCN) 



When a subscription is removed, the subscriber takes actions implied by the following 
pseudo-code: 



RemoveSubscription(SOID, SINST, POID, PINST, PSID, TOPIC, SCN) 
{ 

// see if row exists in the subscriptions queue 
## IF EXISTS ( 

## SELECT SKEY FROM SUBSCRIPTIONS_QUEUE 
## WHERE SOID = %SOID% AND SINST = %SINST% 
## AND POID = %POID% AND PINST = %PINST% 

## AND PSID = %PSID% AND TOPIC = %TOPIC%) 

## BEGIN 

## UPDATE SUBSCRIPTIONS_QUEUE 

## SET OPERATION = FALSE, SCN = %SCN% 

## WHERE SOID = %SOID% AND SINST = %SINST% 

## AND POID = %POID% AND PINST = %PINST% 

## AND PSID = %PSID% AND TOPIC = %TOPIC% 

##END 

##ELSE 

## BEGIN 

// row does not exist; insert into the queue 
## INSERT INTO SUBSCRIPTION_QUEUE 

## VALUES (%SOID%, %SINST%, %TOPIC%, %POID%, %PINST%, 
FALSE, %SCN%) 
##END 

} 



When the update interval timer goes off at the subscriber, it takes actions implied by 
the following pseudo-code: 
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ProcessQueue(PSE), TOPIC) 
{ 

UpdateSubscriptionMap request; 

// select requests in the queue for this PSID; order them by 

// PUID then by OPERATION. The rows in each group will result 

// in addSubscription and deleteSubscription subMessage 

## SELECT * FROM PUBLIC ATION_QUEUE 

## WHERE PSID = %PSID% AND TOPIC = %TOPIC% 

## ORDER BY POID, PINST, OPERATION 

request += GenerateMessageQ; 

// Send request to the publisher 
Send(PSID, request); 

// Assume the worst and ^e the connection 
## UPDATE CONNECTIONS 
## SET RETRY = RETRY + 1 
## WHERE SID = %SSID% 

Li ^ 



When a subscriber receives a request, the actions impUed by the following pseudo- 
code are performed: , 



OnUpdateSubscriptionData(PSID, request) 

{ 

UpdateSubscriptionDataResponse response; 

// Mark this connection as live 
## UPDATE CONNECTIONS 
## SET RETRY -0 
## WHERE SID = %PSID% 

// request may contain multiple entities 
for (each entity in request) 

{ 

for (sub in entity) 
{ 

// check to see if this is a known subscriber 
if (LookUpUser(sub.SOID, sub.SINST)) 

I 
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// is this a duplicate request message? I can find this by looking 

// at change numbers 

## SELECT PCN AS STORED_PCN 

## FROM SUBSCRIPTIONS 

## WHERE POED = %POID% AND PINST = %PINT% 
## AND son) = %SOID% AND SINST = %SINST% 
## AND TOPIC = %TOPIC% AND PSID = %PSID% 

// result set empty means subscriber does not have 
// a subscription on pubhsher's document 
if (result set is empty) 
{ 

// do not send a response for this request. 
// send prepare for an unsub request instead 
## IF NOT EXISTS ( 

## SELECT * FROM SUBSCRIPTIONS_QUEUE 

## WHERE POK) = %POID% AND PINST = %PINST% 

## AND son) = %SOID% AND SINST = %SINST% 

## AND TOPIC = %TOPIC% AND %PSID% = %PSID%) 

ffjf BEGIN 

RemoveSubscription(%SOID%, 

%SINST%, %POID%, %PINST%, 

%PSID%, %TOPIC%, %SCN%); 

##END 

} 

// pen is the change number present in the message 
else 

{ 

if (entity.PCN > STORED_PCN) 
{ 

// This function updates subscribed data 
UpdateData(entity); 

// update the change mmiber 
## UPDATE SUBSCRIPTIONS 
##SETPCN = entity.PCN 

## WHERE POID = %POID% AND PINST = %PINT% 
## AND son) = %SOID% AND SINST = %SINST% 
## AND TOPIC = %TOPIC% AND PSID = %PSID% 

} 

// append to response 
response += "<updatedData>"; 
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} 



else 

// subscriber is unknown; signal publishing service to delete it 

response += "<deleteFromSubscriptionMap "; 

response -H= "subscribeT="'+SOEH"' instance='"+SINST+"7>"; 

} 

} 

} 



Send(SSID, response); 

} 



When a subscriber receives an UpdateSubscriptionMapResponse message, the actions 
implied by the following pseudo-code are performed: 

OnUpdateSubsariptionMapResponse(PSID, request) 
{ 

// Mark this connection as live 
## UPDATE CONNECTIONS 
## SET RETRY = 0 
## WHERE SID = %PSID% 

// The response has one entity for each row in subscription queue 

for (each entity in response) 

{ 

if (entity == "<addedToSubscriptionMap>") 
{ 

for (sub in entity) 
{ 

// publisher successfully added its subscription map 
// subscriber now adds to its subscriptions table 

## IF EXISTS ( 

## SELECT * FROM SUBSCRIPTIONS_QUEUE 
## WHERE POID = %POID% AND PINST = %PINT% 
m AND son) = %SOID% AND SINST = %SINST% 
## AND TOPIC = %TOPIC% AND PSID = %PSID% 
## AND SCN = %SCN%) 
m BEGIN 

## INSERT INTO SUBSCRIPTIONS 
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## 
## 



VALUES (%SOID%, %SINST%, %POID%, 
%PINST%, %PSID%, 0, 
%TOPIC%) 



// since request has received the proper response, 
// it can be deleted from the subscriptions queue 
## DELETE FROM SUBSCRIPTIONS_QUEUE 

## WHERE POID = %POID% AND PINST = 

%PINT% 

## ANDSOID = %SOID%ANDSINST = 

%SINST% 

## AND TOPIC = %TOPIC% AND PSID = 

%PSID% 

## AND OPERATION = 1 
## ANDSCN = %SCN% 
##END 

} 

} 

if (entity = "<deletedFromSubscriptionMap>") 
{ 

for (sub in entity) 

// publisher successfully deleted from its subscription map 
// subscriber now deletes from its subscriptions table 

## IF EXISTS ( 

## SELECT * FROM SUBSCRIPTIONS_QUEUE 
## WHERE POID = %POID% AND PINST = %PINT% 
## ANDSOID = %SOID%ANDSINST = %SINST% 
## AND TOPIC = %TOPIC% AND PSID = %PSID% 
## AND SCN = %SCN%) 
## BEGIN 

## DELETE FROM SUBSCRIPTIONS 

## WHERE POID = %POID% AND PINST = 

%PINT% 

m ANDSOID = %SOID%ANDSINST = 

%SINST% 

## AND TOPIC = %TOPIC% AND PSID = 

%PSID% 

// since request has received the proper response, 
// it can be deleted from the subscriptions queue 
m DELETE FROM SUBSCRIPTIONS_QUEUE 

## WHERE POID = %POID% AND PINST = 

%PINT% 

## AND son) = %SOID% AND SINST = 

%SINST% 

## AND TOPIC = %TOPIC% AND PSID = 

%PSID% 
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## ANDSCN = %SCN% 

##END 

} 

} 

} 

} 



Eventually .NET services are expected to handle hundreds of millions of users. As a 
5 resxilt, the implementation should be extremely scalable and fault-tolerant. One way in which 
J;^ this may be achieved is by having multiple clusters, with each cluster having front-end servers 
i;l and backend servers, hi one architecture, every backend server will handle the data for a 

r fi subset of users. FIG. 22 represents one such cluster architecture. 

I 

1'3 As represented in FIG. 22, when a request comes in, the load balancer redirects the 

10 request to a front end server (FE), based on load balancing and fault-tolerance considerations. 

i n The FE does some preliminary processing on the request, locates the back-end server (BE) 

Q 

U servicing this user, and forwards the request to the back end server. The BE returns with a 
response, which the FE puts into an appropriate message format (e.g., .NET data language) 
and sends it off to its destination. Note the as a result from this architecture, the FEs are 
1 5 stateless; they carry no memory of previous .NET data language requests. As a result, any FE 
can handle any given request. Thus, two messages bound for the same BE can be processed by 
two different FEs. Further, because FEs are stateless, the load-balancer, on an incoming 
request, can distribute load by choosing an FE which is not busy. The same property allows 
the load balancer to be fault-tolerant when an FE fails. The BE is stateful; when required by 
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the semantics of a service, the BE remembers history. Moreover, each BE services a subset of 
the users of the entire service, and while the choice of an FE is arbitrary, a ^ven request 
always corresponds to one specific BE - the one which stored the user's data. 

hi FIG. 22, the arrows labeled with circled numerals one (1) through eight (8) 
5 represent the data flow on a typical request, with (1), a request comes to the service's load 
balancer 2200. Then, the load balancer determines that FE3 is the right front-end to handle 
this request (based on load and failover considerations), and (2) provides the request to FE3 
which processes the request. FE3 determines the user identity, and locates the BE that 
services this user, which in the present example, is BEi. FE3 determines what data is needed 
1 0 from the backend, and FES sends database requests to BEi (arrow labeled three (3)). 

In turn, BEi retrieves the required data from the database (arrows labeled four (4) and 
five (5)), and BEi sends data back to FE3, in the form of database response (arrow six (6)). 
Then, FE3 returns the data back into an appropriate response and sends the message off to its 
destination (arrows labeled seven (7) and eight (8)). 
1 5 The model represented in FIG. 22 works fine for handhng incoming SSCP requests. 

For example, when an updateSubscriptionMap request comes into a pubUsher, it is processed 
in the general manner described above. However, for outgomg requests, such as when the 
publisher needs to send the updateSubscriptionData message, an enhanced model is provided, 
generally because in the SSCP protocol, a publisher or a subscriber processes its queue every 
20 time the interval timer goes off, and for the protocol to function correctly, a single reader 
should drain the queue, and also because in the model described in the previous section, the 
BE has no reason to initiate a request message; its job is to process a request and generate an 
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appropriate response. However, SSCP requires that the participating services generate 
requests when the interval timer goes off: 

a) A publisher sends updateSubscriptionData messages 

b) A subscribe sends updateSubscriptionMap messages 

5 

This is handled as below, wherein for the purposes of this description, the word 
"service" refers to either the pubUsher or the subscriber, and the word "queue" refers to either 
the publication queue or the subscription queue. To enhance the model, the FEs run code for 
u inbound SSCP messages, just as they do for other inbound .NET data language messages. 
□10 This means that the FEs run code for updating subscription data (on the subscribing side), 
''i code for updating subscription maps (on the publishing side), and processing SSCP responses 
% (both subscriber and publisher). 

The BEs run code for outbound SSCP messages. This code runs every time the 

h 

i U interval timer goes off. This code handles the publication queue and generatmg 
;'3 15 updateSubscriptionData messages (publisher), handling subscription queue and generating 
updateSubscriptionMap messages (subscriber). The process generally works as follows: 
1) Each BE stores a slice of the persistent SSCP data. Taking the example of a pubUshing 
service, if BEl m^iages usern and nsern, and BE2 manages useraz and user22 then 
BEi stores PUBLICATIONS and PUBLICATIONS_QUEUE and CONNECTION 
20 tables which handle the subscription / publication requirements for data from usem 

and useri2. BE2 stores PUBLICATIONS and PUBLICATIONS_QUEUE and 
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CONNECTION tables which handle the sub/pub requirements for data from user22 and 
user22. 

2) When the interval timer goes off at a service, each BE wakes up to process its queue. 

3) If the queue is not empty, then the BE constructs the appropriate message(s) - such as 
updateSubscriptionData, or updateSubscriptionMap. For each message: 

a) The BE picks an FE (e.g., at random) and sends the message to it. 

b) The FE simply forwards the message along to its destination - i.e., it acts as a proxy, 

c) A response is handled in the usual way (since incoming SSCP messages don't require 
any changes) 

FIG. 23 generally represents this model when the interval timer goes off and the 
following things happen at BEi (similar things also happen at other BEs). Assume that BEi 
has to send two requests, requestl and request2, as a result of processing its queue during Ihis 
interval timer event. In the arrows labeled (A), BEi sends requestl through FE3, which is 
randomly picked. The arrows labeled (B) represent a response arriving from a destination 
service through FE2, which is picked by the load balancer according to its algorithms. The 
arrows labeled (C) represent BE sending request2 through randomly picked FEi. The arrows 
labeled (D) represent a response arriving from a destination service through FEi (which is 
picked by the load balancer according to its algorithms). 
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As can be seen from the foregoing detailed description, there is provided a set of 
schema-based services that provide users with access to centrally stored data. The set of 
services control access to the data with defined methods, regardless of the application program 
and/or device. When accessed, the data for each service is structured in a defined way that 
complies with defmed rules for that data, regardless of the application program or device that 
is accessing the data. The schemas have extensibility defined therein. 

While the invention is susceptible to various modifications and alternative 
constructions, certain illustrated embodiments thereof are shown in the drawings and have 
been described above in detail. It should be understood, however, that there is no intention to 
Umit the mvention to the specific forms disclosed, but on the contrary, the intention is to cover 
all modifications, alternative constructions, and equivalents falling within the spirit and scope 
of the invention. 
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